| blob | 65451a2c18a5f48f3fd9572a2f8cdd9c6cadc11b |
1 ------------------------------------------------------------------------------
2 -- --
3 -- GNAT COMPILER COMPONENTS --
4 -- --
5 -- D E B U G --
6 -- --
7 -- B o d y --
8 -- --
9 -- Copyright (C) 1992-2018, 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. --
17 -- --
18 -- As a special exception under Section 7 of GPL version 3, you are granted --
19 -- additional permissions described in the GCC Runtime Library Exception, --
20 -- version 3.1, as published by the Free Software Foundation. --
21 -- --
22 -- You should have received a copy of the GNU General Public License and --
23 -- a copy of the GCC Runtime Library Exception along with this program; --
24 -- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
25 -- <http://www.gnu.org/licenses/>. --
26 -- --
27 -- GNAT was originally developed by the GNAT team at New York University. --
28 -- Extensive contributions were provided by Ada Core Technologies Inc. --
29 -- --
30 ------------------------------------------------------------------------------
34 ---------------------------------
35 -- Summary of Debug Flag Usage --
36 ---------------------------------
38 -- Debug flags for compiler (GNAT1)
40 -- da Generate messages tracking semantic analyzer progress
41 -- db Show encoding of type names for debug output
42 -- dc List names of units as they are compiled
43 -- dd Dynamic allocation of tables messages generated
44 -- de List the entity table
45 -- df Full tree/source print (includes withed units)
46 -- dg Print source from tree (generated code only)
47 -- dh Generate listing showing loading of name table hash chains
48 -- di Generate messages for visibility linking/delinking
49 -- dj Suppress "junk null check" for access parameter values
50 -- dk Generate GNATBUG message on abort, even if previous errors
51 -- dl Generate unit load trace messages
52 -- dm Prevent special frontend inlining in GNATprove mode
53 -- dn Generate messages for node/list allocation
54 -- do Print source from tree (original code only)
55 -- dp Generate messages for parser scope stack push/pops
56 -- dq No auto-alignment of small records
57 -- dr Generate parser resynchronization messages
58 -- ds Print source from tree (including original and generated stuff)
59 -- dt Print full tree
60 -- du Uncheck categorization pragmas
61 -- dv Output trace of overload resolution
62 -- dw Print trace of semantic scope stack
63 -- dx Force expansion on, even if no code being generated
64 -- dy Print tree of package Standard
65 -- dz Print source of package Standard
67 -- dA All entities included in representation information output
68 -- dB Output debug encoding of type names and variants
69 -- dC Output debugging information on check suppression
70 -- dD Delete elaboration checks in inner level routines
71 -- dE Apply elaboration checks to predefined units
72 -- dF Perform the new SPARK checking rules for pointer aliasing
73 -- dG Generate all warnings including those normally suppressed
74 -- dH Hold (kill) call to gigi
75 -- dI Inhibit internal name numbering in gnatG listing
76 -- dJ Prepend subprogram name in messages
77 -- dK Kill all error messages
78 -- dL Ignore external calls from instances for elaboration
79 -- dM Assume all variables are modified (no current values)
80 -- dN No file name information in exception messages
81 -- dO Output immediate error messages
82 -- dP Do not check for controlled objects in preelaborable packages
83 -- dQ Use old secondary stack method
84 -- dR Bypass check for correct version of s-rpc
85 -- dS Never convert numbers to machine numbers in Sem_Eval
86 -- dT Convert to machine numbers only for constant declarations
87 -- dU Enable garbage collection of unreachable entities
88 -- dV Enable viewing of all symbols in debugger
89 -- dW Disable warnings on calls for IN OUT parameters
90 -- dX Display messages on reads of potentially uninitialized scalars
91 -- dY Enable configurable run-time mode
92 -- dZ Generate listing showing the contents of the dispatch tables
94 -- d.a Force Target_Strict_Alignment mode to True
95 -- d.b Dump backend types
96 -- d.c Generate inline concatenation, do not call procedure
97 -- d.d Disable atomic synchronization
98 -- d.e Enable atomic synchronization
99 -- d.f Inhibit folding of static expressions
100 -- d.g Enable conversion of raise into goto
101 -- d.h Minimize the creation of public internal symbols for concatenation
102 -- d.i Ignore Warnings pragmas
103 -- d.j Generate listing of frontend inlined calls
104 -- d.k Kill referenced run-time library unit line numbers
105 -- d.l Use Ada 95 semantics for limited function returns
106 -- d.m For -gnatl, print full source only for main unit
107 -- d.n Print source file names
108 -- d.o Conservative elaboration order for indirect calls
109 -- d.p Use original Ada 95 semantics for Bit_Order (disable AI95-0133)
110 -- d.q Suppress optimizations on imported 'in'
111 -- d.r Disable reordering of components in record types
112 -- d.s Strict secondary stack management
113 -- d.t Disable static allocation of library level dispatch tables
114 -- d.u Enable Modify_Tree_For_C (update tree for c)
115 -- d.v Enforce SPARK elaboration rules in SPARK code
116 -- d.w Do not check for infinite loops
117 -- d.x No exception handlers
118 -- d.y Disable implicit pragma Elaborate_All on task bodies
119 -- d.z Restore previous support for frontend handling of Inline_Always
121 -- d.A Read/write Aspect_Specifications hash table to tree
122 -- d.B Generate a bug box on abort_statement
123 -- d.C Generate concatenation call, do not generate inline code
124 -- d.D Disable errors on use of overriding keyword in Ada 95 mode
125 -- d.E Turn selected errors into warnings
126 -- d.F Debug mode for GNATprove
127 -- d.G Ignore calls through generic formal parameters for elaboration
128 -- d.H GNSA mode for ASIS
129 -- d.I Do not ignore enum representation clauses in CodePeer mode
130 -- d.J Relaxed rules for pragma No_Return
131 -- d.K Enable generation of contract-only procedures in CodePeer mode
132 -- d.L Depend on back end for limited types in if and case expressions
133 -- d.M Relaxed RM semantics
134 -- d.N Add node to all entities
135 -- d.O Dump internal SCO tables
136 -- d.P Previous (non-optimized) handling of length comparisons
137 -- d.Q Previous (incomplete) style check for binary operators
138 -- d.R Restrictions in ali files in positional form
139 -- d.S Force Optimize_Alignment (Space)
140 -- d.T Force Optimize_Alignment (Time)
141 -- d.U Ignore indirect calls for static elaboration
142 -- d.V Do not verify validity of SCIL files (CodePeer mode)
143 -- d.W Print out debugging information for Walk_Library_Items
144 -- d.X Old treatment of indexing aspects
145 -- d.Y
146 -- d.Z Do not enable expansion in configurable run-time mode
148 -- d_a Stop elaboration checks on accept or select statement
149 -- d_b
150 -- d_c
151 -- d_d
152 -- d_e Ignore entry calls and requeue statements for elaboration
153 -- d_f Issue info messages related to GNATprove usage
154 -- d_g
155 -- d_h
156 -- d_i Ignore activations and calls to instances for elaboration
157 -- d_j
158 -- d_k
159 -- d_l
160 -- d_m
161 -- d_n
162 -- d_o
163 -- d_p Ignore assertion pragmas for elaboration
164 -- d_q
165 -- d_r
166 -- d_s Stop elaboration checks on synchronous suspension
167 -- d_t
168 -- d_u
169 -- d_v
170 -- d_w
171 -- d_x
172 -- d_y
173 -- d_z
175 -- d_A Stop generation of ALI file
176 -- d_B
177 -- d_C
178 -- d_D
179 -- d_E
180 -- d_F
181 -- d_G
182 -- d_H
183 -- d_I
184 -- d_J
185 -- d_K
186 -- d_L Output trace information on elaboration checking
187 -- d_M
188 -- d_N
189 -- d_O
190 -- d_P
191 -- d_Q
192 -- d_R
193 -- d_S
194 -- d_T
195 -- d_U
196 -- d_V
197 -- d_W
198 -- d_X
199 -- d_Y
200 -- d_Z
202 -- d1 Error msgs have node numbers where possible
203 -- d2 Eliminate error flags in verbose form error messages
204 -- d3 Dump bad node in Comperr on an abort
205 -- d4 Inhibit automatic krunch of predefined library unit files
206 -- d5 Debug output for tree read/write
207 -- d6 Default access unconstrained to thin pointers
208 -- d7 Suppress version/source stamp/compilation time for -gnatv/-gnatl
209 -- d8 Force opposite endianness in packed stuff
210 -- d9 Allow lock free implementation
212 -- d.1 Enable unnesting of nested procedures
213 -- d.2 Allow statements in declarative part
214 -- d.3 Output debugging information from Exp_Unst
215 -- d.4 Do not delete generated C file in case of errors
216 -- d.5 Do not generate imported subprogram definitions in C code
217 -- d.6 Do not avoid declaring unreferenced types in C code
218 -- d.7 Disable unsound heuristics in gnat2scil (for CP as SPARK prover)
219 -- d.8
220 -- d.9 Disable build-in-place for nonlimited types
222 -- d_1
223 -- d_2
224 -- d_3
225 -- d_4
226 -- d_5
227 -- d_6
228 -- d_7
229 -- d_8
230 -- d_9
232 -- Debug flags for binder (GNATBIND)
234 -- da All links (including internal units) listed if there is a cycle
235 -- db Output information from Better_Choice
236 -- dc List units as they are chosen
237 -- dd
238 -- de Elaboration dependencies including system units
239 -- df
240 -- dg
241 -- dh
242 -- di Ignore_Errors mode for reading ali files
243 -- dj
244 -- dk
245 -- dl
246 -- dm
247 -- dn List details of manipulation of Num_Pred values
248 -- do Use older preference for elaboration order
249 -- dp Use old preference for elaboration order
250 -- dq
251 -- dr
252 -- ds
253 -- dt
254 -- du List units as they are acquired
255 -- dv Verbose debugging printouts
256 -- dw
257 -- dx Force binder to read xref information from ali files
258 -- dy
259 -- dz
261 -- Debug flags used in package Make and its clients (e.g. GNATMAKE)
263 -- da
264 -- db
265 -- dc
266 -- dd
267 -- de
268 -- df Only output file names, not path names, in log
269 -- dg
270 -- dh Generate listing showing loading of name table hash chains
271 -- di
272 -- dj
273 -- dk
274 -- dl
275 -- dm Display the number of maximum simultaneous compilations
276 -- dn Do not delete temp files created by gnatmake
277 -- do
278 -- dp Prints the contents of the Q used by Make.Compile_Sources
279 -- dq Prints source files as they are enqueued and dequeued
280 -- dr
281 -- ds
282 -- dt Display time stamps when there is a mismatch
283 -- du List units as their ali files are acquired
284 -- dv
285 -- dw Prints the list of units withed by the unit currently explored
286 -- dx
287 -- dy
288 -- dz
290 --------------------------------------------
291 -- Documentation for Compiler Debug Flags --
292 --------------------------------------------
294 -- da Generate messages tracking semantic analyzer progress. A message
295 -- is output showing each node as it gets analyzed, expanded,
296 -- resolved, or evaluated. This option is useful for finding out
297 -- exactly where a bomb during semantic analysis is occurring.
299 -- db In Exp_Dbug, certain type names are encoded to include debugging
300 -- information. This debug switch causes lines to be output showing
301 -- the encodings used.
303 -- dc List names of units as they are compiled. One line of output will
304 -- be generated at the start of compiling each unit (package or
305 -- subprogram).
307 -- dd Dynamic allocation of tables messages generated. Each time a
308 -- table is reallocated, a line is output indicating the expansion.
310 -- de List the entity table
312 -- df Full tree/source print (includes withed units). Normally the tree
313 -- output (dt) or recreated source output (dg,do,ds) includes only
314 -- the main unit. If df is set, then the output in either case
315 -- includes all compiled units (see also dg,do,ds,dt). Note that to
316 -- be effective, this switch must be used in combination with one or
317 -- more of dt, dg, do or ds.
319 -- dg Print the source recreated from the generated tree. In the case
320 -- where the tree has been rewritten this output includes only the
321 -- generated code, not the original code (see also df,do,ds,dz).
322 -- This flag differs from -gnatG in that the output also includes
323 -- non-source generated null statements, and freeze nodes, which
324 -- are normally omitted in -gnatG mode.
326 -- dh Generates a table at the end of a compilation showing how the hash
327 -- table chains built by the Namet package are loaded. This is useful
328 -- in ensuring that the hashing algorithm (in Namet.Hash) is working
329 -- effectively with typical sets of program identifiers.
331 -- di Generate messages for visibility linking/delinking
333 -- dj Suppress "junk null check" for access parameters. This flag permits
334 -- Ada programs to pass null parameters to access parameters, and to
335 -- explicitly check such access values against the null literal.
336 -- Neither of these is valid Ada, but both were allowed in versions of
337 -- GNAT before 3.10, so this switch can ease the transition process.
339 -- dk Immediate kill on abort. Normally on an abort (i.e. a call to
340 -- Comperr.Compiler_Abort), the GNATBUG message is not given if
341 -- there is a previous error. This debug switch bypasses this test
342 -- and gives the message unconditionally (useful for debugging).
344 -- dl Generate unit load trace messages. A line of traceback output is
345 -- generated each time a request is made to the library manager to
346 -- load a new unit.
348 -- dm Prevent special frontend inlining in GNATprove mode. In some cases,
349 -- some subprogram calls are inlined in GNATprove mode in order to
350 -- facilitate formal verification. This debug switch prevents that
351 -- inlining to happen.
353 -- dn Generate messages for node/list allocation. Each time a node or
354 -- list header is allocated, a line of output is generated. Certain
355 -- other basic tree operations also cause a line of output to be
356 -- generated. This option is useful in seeing where the parser is
357 -- blowing up.
359 -- do Print the source recreated from the generated tree. In the case
360 -- where the tree has been rewritten, this output includes only the
361 -- original code, not the generated code (see also df,dg,ds,dz).
363 -- dp Generate messages for parser scope stack push/pops. A line of
364 -- output by the parser each time the parser scope stack is either
365 -- pushed or popped. Useful in debugging situations where the
366 -- parser scope stack ends up incorrectly synchronized
368 -- dq In layout version 1.38, 2002/01/12, a circuit was implemented
369 -- to give decent default alignment to short records that had no
370 -- specific alignment set. This debug option restores the previous
371 -- behavior of giving such records poor alignments, typically 1.
372 -- This may be useful in dealing with transition.
374 -- dr Generate parser resynchronization messages. Normally the parser
375 -- resynchronizes quietly. With this debug option, two messages
376 -- are generated, one when the parser starts a resynchronization
377 -- skip, and another when it resumes parsing. Useful in debugging
378 -- inadequate error recovery situations.
380 -- ds Print the source recreated from the generated tree. In the case
381 -- where the tree has been rewritten this output includes both the
382 -- generated code and the original code with the generated code
383 -- being enlosed in curly brackets (see also df,do,ds,dz)
385 -- dt Print full tree. The generated tree is output (see also df,dy)
387 -- du Uncheck categorization pragmas. This debug switch causes the
388 -- elaboration control pragmas (Pure, Preelaborate, etc.) and the
389 -- categorization pragmas (Shared_Passive, Remote_Types, etc.) to be
390 -- ignored, so that normal checks are not made (this is particularly
391 -- useful for adding temporary debugging code to units that have
392 -- pragmas that are inconsistent with the debugging code added).
394 -- dv Output trace of overload resolution. Outputs messages for
395 -- overload attempts that involve cascaded errors, or where
396 -- an interpretation is incompatible with the context.
398 -- dw Write semantic scope stack messages. Each time a scope is created
399 -- or removed, a message is output (see the Sem_Ch8.Push_Scope and
400 -- Sem_Ch8.Pop_Scope subprograms).
402 -- dx Force expansion on, even if no code being generated. Normally the
403 -- expander is inhibited if no code is generated. This switch forces
404 -- expansion to proceed normally even if the backend is not being
405 -- called. This is particularly useful for debugging purposes when
406 -- using the front-end only version of the compiler (which normally
407 -- would never do any expansion).
409 -- dy Print tree of package Standard. Normally the tree print out does
410 -- not include package Standard, even if the -df switch is set. This
411 -- switch forces output of the internal tree built for Standard.
413 -- dz Print source of package Standard. Normally the source print out
414 -- does not include package Standard, even if the -df switch is set.
415 -- This switch forces output of the source recreated from the internal
416 -- tree built for Standard. Note that this differs from -gnatS in
417 -- that it prints from the actual tree using the normal Sprint
418 -- circuitry for printing trees.
420 -- dA Forces output of representation information, including full
421 -- information for all internal type and object entities, as well
422 -- as all user defined type and object entities including private
423 -- and incomplete types. This debug switch also automatically sets
424 -- the equivalent of -gnatRm.
426 -- dB Output debug encodings for types and variants. See Exp_Dbug for
427 -- exact form of the generated output.
429 -- dC Output trace information showing the decisions made during
430 -- check suppression activity in unit Checks.
432 -- dD Delete new elaboration checks. This flag causes GNAT to return
433 -- to the 3.13a elaboration semantics, and to suppress the fixing
434 -- of two bugs. The first is in the context of inner routines in
435 -- dynamic elaboration mode, when the subprogram we are in was
436 -- called at elaboration time by a unit that was also compiled with
437 -- dynamic elaboration checks. In this case, if A calls B calls C,
438 -- and all are in different units, we need an elaboration check at
439 -- each call. These nested checks were only put in recently (see
440 -- version 1.80 of Sem_Elab) and we provide this debug flag to
441 -- revert to the previous behavior in case of regressions. The
442 -- other behavior reverted by this flag is the treatment of the
443 -- Elaborate_Body pragma in static elaboration mode. This used to
444 -- be treated as not needing elaboration checking, but in fact in
445 -- general Elaborate_All is still required because of nested calls.
447 -- dE Apply compile time elaboration checking for with relations between
448 -- predefined units. Normally no checks are made.
450 -- dF Perform the new SPARK checking rules for pointer aliasing. This is
451 -- only activated in GNATprove mode and on SPARK code. These rules are
452 -- not yet part of the official SPARK language, but are expected to be
453 -- included in a future version of SPARK.
455 -- dG Generate all warnings. Normally Errout suppresses warnings on
456 -- units that are not part of the main extended source, and also
457 -- suppresses warnings on instantiations in the main extended
458 -- source that duplicate warnings already posted on the template.
459 -- This switch stops both kinds of deletion and causes Errout to
460 -- post all warnings sent to it.
462 -- dH Inhibit call to gigi. This is useful for testing front end data
463 -- layout, and may be useful in other debugging situations where
464 -- you do not want gigi to intefere with the testing.
466 -- dI Inhibit internal name numbering in gnatDG listing. Any sequence of
467 -- the form <uppercase-letter><digits><lowercase-letter> appearing in
468 -- a name is replaced by <uppercase-letter>...<lowercase-letter>. This
469 -- is used in the fixed bugs run to minimize system and version
470 -- dependency in filed -gnatD or -gnatG output.
472 -- dJ Prepend the name of the enclosing subprogram in compiler messages
473 -- (errors, warnings, style checks). This is useful in particular to
474 -- integrate compiler warnings in static analysis tools such as
475 -- CodePeer.
477 -- dK Kill all error messages. This debug flag suppresses the output
478 -- of all error messages. It is used in regression tests where the
479 -- error messages are target dependent and irrelevant.
481 -- dL The compiler ignores calls in instances and invoke subprograms
482 -- which are external to the instance for both the static and dynamic
483 -- elaboration models.
485 -- dM Assume all variables have been modified, and ignore current value
486 -- indications. This debug flag disconnects the tracking of constant
487 -- values (see Exp_Ch2.Expand_Current_Value).
489 -- dN Do not generate file name information in exception messages
491 -- dO Output immediate error messages. This causes error messages to
492 -- be output as soon as they are generated (disconnecting several
493 -- circuits for improvement of messages, deletion of duplicate
494 -- messages etc). Useful to diagnose compiler bombs caused by
495 -- erroneous handling of error situations
497 -- dP Do not check for controlled objects in preelaborable packages.
498 -- RM 10.2.1(9) forbids the use of library level controlled objects
499 -- in preelaborable packages, but this restriction is a huge pain,
500 -- especially in the predefined library units.
502 -- dQ Use old method for determining what goes on the secondary stack.
503 -- This disables some newer optimizations. The intent is to use this
504 -- temporarily to measure before/after efficiency. ???Remove this
505 -- when we are done (see Sem_Util.Requires_Transient_Scope).
507 -- dR Bypass the check for a proper version of s-rpc being present
508 -- to use the -gnatz? switch. This allows debugging of the use
509 -- of stubs generation without needing to have GLADE (or some
510 -- other PCS installed).
512 -- dS Omit conversion of fpt numbers to exact machine numbers in
513 -- non-static evaluation contexts (see Check_Non_Static_Context).
514 -- This is intended for testing out timing problems with this
515 -- conversion circuit.
517 -- dT Similar to dS, but omits the conversions only in the case where
518 -- the parent is not a constant declaration.
520 -- dU Enable garbage collection of unreachable entities. This enables
521 -- both the reachability analysis and changing the Is_Public and
522 -- Is_Eliminated flags.
524 -- dV Enable viewing of all symbols in debugger. Causes debug information
525 -- to be generated for all symbols, including internal symbols. This
526 -- is enabled by default for -gnatD, but this switch allows this to
527 -- be enabled without generating modified source files. Note that the
528 -- use of -gnatdV ensures in the dwarf/elf case that all symbols that
529 -- are present in the elf tables are also in the dwarf tables (which
530 -- seems to be required by some tools). Another effect of dV is to
531 -- generate full qualified names, including internal names generated
532 -- for blocks and loops.
534 -- dW Disable warnings when a possibly uninitialized scalar value is
535 -- passed to an IN OUT parameter of a procedure. This usage is a
536 -- quite improper bounded error [erroneous in Ada 83] situation,
537 -- and would normally generate a warning. However, to ease the
538 -- task of transitioning incorrect legacy code, we provide this
539 -- undocumented feature for suppressing these warnings.
541 -- dY Enable configurable run-time mode, just as though the System file
542 -- had Configurable_Run_Time_Mode set to True. This is useful in
543 -- testing high integrity mode.
545 -- dZ Generate listing showing the contents of the dispatch tables. Each
546 -- line has an internally generated number used for references between
547 -- tagged types and primitives. For each primitive the output has the
548 -- following fields:
549 --
550 -- - Letter 'P' or letter 's': The former indicates that this
551 -- primitive will be located in a primary dispatch table. The
552 -- latter indicates that it will be located in a secondary
553 -- dispatch table.
554 --
555 -- - Name of the primitive. In case of predefined Ada primitives
556 -- the text "(predefined)" is added before the name, and these
557 -- acronyms are used: SR (Stream_Read), SW (Stream_Write), SI
558 -- (Stream_Input), SO (Stream_Output), DA (Deep_Adjust), DF
559 -- (Deep_Finalize). In addition Oeq identifies the equality
560 -- operator, and "_assign" the assignment.
561 --
562 -- - If the primitive covers interface types, two extra fields
563 -- referencing other primitives are generated: "Alias" references
564 -- the primitive of the tagged type that covers an interface
565 -- primitive, and "AI_Alias" references the covered interface
566 -- primitive.
567 --
568 -- - The expression "at #xx" indicates the slot of the dispatch
569 -- table occupied by such primitive in its corresponding primary
570 -- or secondary dispatch table.
571 --
572 -- - In case of abstract subprograms the text "is abstract" is
573 -- added at the end of the line.
575 -- d.a Force Target_Strict_Alignment to True, even on targets where it
576 -- would normally be false. Can be used for testing strict alignment
577 -- circuitry in the compiler.
579 -- d.b Dump back end types. During Create_Standard, the back end is
580 -- queried for all available types. This option shows them.
582 -- d.c Generate inline concatenation, instead of calling one of the
583 -- System.Concat_n.Str_Concat_n routines in cases where the latter
584 -- routines would normally be called.
586 -- d.d Disable atomic synchronization for all atomic variable references.
587 -- Pragma Enable_Atomic_Synchronization is ignored.
589 -- d.e Enable atomic synchronization for all atomic variable references.
590 -- Pragma Disable_Atomic_Synchronization is ignored, and also the
591 -- compiler switch -gnated is ignored.
593 -- d.f Suppress folding of static expressions. This of course results
594 -- in seriously non-conforming behavior, but is useful sometimes
595 -- when tracking down handling of complex expressions.
597 -- d.g Enables conversion of a raise statement into a goto when the
598 -- relevant handler is statically determinable. For now we only try
599 -- this if this debug flag is set. Later we will enable this more
600 -- generally by default.
602 -- d.h Minimize the creation of public internal symbols for concatenation
603 -- by enforcing a secondary stack-like handling of the final result.
604 -- The target of the concatenation is thus constrained in place and
605 -- initialized with the result instead of acting as its alias.
607 -- d.i Ignore all occurrences of pragma Warnings in the sources. This can
608 -- be used in particular to disable Warnings (Off) to check if any of
609 -- these statements are inappropriate.
611 -- d.k If an error message contains a reference to a location in an
612 -- internal unit, then suppress the line number in this reference.
614 -- d.j Generate listing of frontend inlined calls and inline calls passed
615 -- to the backend. This is useful to locate skipped calls that must be
616 -- inlined by the frontend.
618 -- d.l Use Ada 95 semantics for limited function returns. This may be
619 -- used to work around the incompatibility introduced by AI-318-2.
620 -- It is useful only in Ada 2005 and later.
622 -- d.m When -gnatl is used, the normal output includes full listings of
623 -- all files in the extended main source (body/spec/subunits). If this
624 -- debug switch is used, then the full listing is given only for the
625 -- main source (this corresponds to a previous behavior of -gnatl and
626 -- is used for running the ACATS tests).
628 -- d.n Print source file names as they are loaded. This is useful if the
629 -- compiler has a bug -- these are the files that need to be included
630 -- in a bug report.
632 -- d.o Conservative elaboration order for indirect calls. This causes
633 -- P'Access to be treated as a call in more cases.
635 -- d.p In Ada 95 (or 83) mode, use original Ada 95 behavior for the
636 -- interpretation of component clauses crossing byte boundaries when
637 -- using the non-default bit order (i.e. ignore AI95-0133).
639 -- d.q If an array variable or constant is not modified in Ada code, and
640 -- is passed to an 'in' parameter of a foreign-convention subprogram,
641 -- and that subprogram modifies the array, the Ada compiler normally
642 -- assumes that the array is not modified. This option suppresses such
643 -- optimizations. This option should not be used; the correct solution
644 -- is to declare the parameter 'in out'.
646 -- d.r Do not reorder components in record types.
648 -- d.s The compiler no longer attempts to optimize the calls to secondary
649 -- stack management routines SS_Mark and SS_Release. As a result, each
650 -- transient block tasked with secondary stack management will fulfill
651 -- its role unconditionally.
653 -- d.s The compiler does not generate calls to secondary stack management
654 -- routines SS_Mark and SS_Release for a transient block when there is
655 -- an enclosing scoping construct which already manages the secondary
656 -- stack.
658 -- d.t The compiler has been modified (a fairly extensive modification)
659 -- to generate static dispatch tables for library level tagged types.
660 -- This debug switch disables this modification and reverts to the
661 -- previous dynamic construction of tables. It is there as a possible
662 -- work around if we run into trouble with the new implementation.
664 -- d.u Sets Modify_Tree_For_C mode in which tree is modified to make it
665 -- easier to generate code using a C compiler.
667 -- d.v This flag enforces the elaboration rules defined in the SPARK
668 -- Reference Manual, chapter 7.7, to all SPARK code within a unit. As
669 -- a result, constructs which violate the rules in chapter 7.7 are no
670 -- longer accepted, even if the implementation is able to statically
671 -- ensure that accepting these constructs does not introduce the
672 -- possibility of failing an elaboration check.
674 -- d.w This flag turns off the scanning of loops to detect possible
675 -- infinite loops.
677 -- d.x No exception handlers in generated code. This causes exception
678 -- handlers to be eliminated from the generated code. They are still
679 -- fully compiled and analyzed, they just get eliminated from the
680 -- code generation step.
682 -- d.y Disable implicit pragma Elaborate_All on task bodies. When a task
683 -- body calls a procedure in the same package, and that procedure
684 -- calls a procedure in another package, the static elaboration
685 -- machinery adds an implicit Elaborate_All on the other package. This
686 -- switch disables the addition of the implicit pragma in such cases.
688 -- d.z Restore previous front-end support for Inline_Always. In default
689 -- mode, for targets that use the GCC back end, Inline_Always is
690 -- handled by the back end. Use of this switch restores the previous
691 -- handling of Inline_Always by the front end on such targets. For the
692 -- targets that do not use the GCC back end, this switch is ignored.
694 -- d.A There seems to be a problem with ASIS if we activate the circuit
695 -- for reading and writing the aspect specification hash table, so
696 -- for now, this is controlled by the debug flag d.A. The hash table
697 -- is only written and read if this flag is set.
699 -- d.B Generate a bug box when we see an abort_statement, even though
700 -- there is no bug. Useful for testing Comperr.Compiler_Abort: write
701 -- some code containing an abort_statement, and compile it with
702 -- -gnatd.B. There is nothing special about abort_statements; it just
703 -- provides a way to control where the bug box is generated. See "when
704 -- N_Abort_Statement" in package body Expander.
706 -- d.C Generate call to System.Concat_n.Str_Concat_n routines in cases
707 -- where we would normally generate inline concatenation code.
709 -- d.D For compatibility with some Ada 95 compilers implementing only
710 -- one feature of Ada 2005 (overriding keyword), disable errors on use
711 -- of overriding keyword in Ada 95 mode.
713 -- d.E Turn selected errors into warnings. This debug switch causes a
714 -- specific set of error messages into warnings. Setting this switch
715 -- causes Opt.Error_To_Warning to be set to True. The intention is
716 -- that this be used for messages representing upwards incompatible
717 -- changes to Ada 2012 that cause previously correct programs to be
718 -- treated as illegal now. The following cases are affected:
719 --
720 -- Errors relating to overlapping subprogram parameters for cases
721 -- other than IN OUT parameters to functions.
722 --
723 -- Errors relating to the new rules about not defining equality
724 -- too late so that composition of equality can be assured.
725 --
726 -- Errors relating to overriding indicators on protected subprogram
727 -- bodies (not an Ada 2012 incompatibility, but might cause errors
728 -- for existing programs assuming they were legal because GNAT
729 -- formerly allowed them).
731 -- d.F Sets GNATprove_Mode to True. This allows debugging the frontend in
732 -- the special mode used by GNATprove.
734 -- d.G Previously the compiler ignored calls via generic formal parameters
735 -- when doing the analysis for the static elaboration model. This is
736 -- now fixed, but we provide this debug flag to revert to the previous
737 -- situation of ignoring such calls to aid in transition.
739 -- d.H Sets ASIS_GNSA_Mode to True. This signals the front end to suppress
740 -- the call to gigi in ASIS_Mode.
742 -- d.I Do not ignore enum representation clauses in CodePeer mode.
743 -- The default of ignoring representation clauses for enumeration
744 -- types in CodePeer is good for the majority of Ada code, but in some
745 -- cases being able to change this default might be useful to remove
746 -- some false positives.
748 -- d.J Relaxed rules for pragma No_Return. A pragma No_Return is illegal
749 -- if it applies to a body. This switch disables the legality check
750 -- for that. If the procedure does in fact return normally, execution
751 -- is erroneous, and therefore unpredictable.
753 -- d.K Enable generation of contract-only procedures in CodePeer mode and
754 -- report a warning on subprograms for which the contract-only body
755 -- cannot be built. Currently reported on subprograms defined in
756 -- nested package specs that have some formal (or return type) whose
757 -- type is a private type defined in some enclosing package and that
758 -- have pre/postconditions.
760 -- d.L Normally the front end generates special expansion for conditional
761 -- expressions of a limited type. This debug flag removes this special
762 -- case expansion, leaving it up to the back end to handle conditional
763 -- expressions correctly.
765 -- d.M Relaxed RM semantics. This flag sets Opt.Relaxed_RM_Semantics
766 -- See Opt.Relaxed_RM_Semantics for more details.
768 -- d.N Enlarge entities by one node (but don't attempt to use this extra
769 -- node for storage of any flags or fields). This can be used to do
770 -- experiments on the impact of increasing entity sizes.
772 -- d.O Dump internal SCO tables. Before outputting the SCO information to
773 -- the ALI file, the internal SCO tables (SCO_Table/SCO_Unit_Table)
774 -- are dumped for debugging purposes.
776 -- d.P Previous non-optimized handling of length comparisons. Setting this
777 -- flag inhibits the effect of Optimize_Length_Comparison in Exp_Ch4.
778 -- This is there in case we find a situation where the optimization
779 -- malfunctions, to provide a work around.
781 -- d.Q Previous incomplete style checks for binary operators. Style checks
782 -- for token separation rules were incomplete and have been made
783 -- compliant with the documentation. For example, no warning was
784 -- issued for expressions such as 16-One or "A"&"B". Setting this flag
785 -- inhibits these new checks.
787 -- d.R As documented in lib-writ.ads, restrictions in the ali file can
788 -- have two forms, positional and named. The named notation is the
789 -- current preferred form, but the use of this debug switch will force
790 -- the use of the obsolescent positional form.
792 -- d.S Force Optimize_Alignment (Space) mode as the default
794 -- d.T Force Optimize_Alignment (Time) mode as the default
796 -- d.U Ignore indirect calls for static elaboration. The static
797 -- elaboration model is conservative, especially regarding indirect
798 -- calls. If you say Proc'Access, it will assume you might call
799 -- Proc. This can cause elaboration cycles at bind time. This flag
800 -- reverts to the behavior of earlier compilers, which ignored
801 -- indirect calls.
803 -- d.V Do not verify the validity of SCIL files (CodePeer mode). When
804 -- generating SCIL files for CodePeer, by default we verify that the
805 -- SCIL is well formed before saving it on disk. This switch can be
806 -- used to disable this checking, either to improve speed or to shut
807 -- down a false positive detected during the verification.
809 -- d.W Print out debugging information for Walk_Library_Items, including
810 -- the order in which units are walked. This is primarily for use in
811 -- debugging CodePeer mode.
813 -- d.X A previous version of GNAT allowed indexing aspects to be redefined
814 -- on derived container types, while the default iterator was
815 -- inherited from the parent type. This nonstandard extension is
816 -- preserved temporarily for use by the modeling project under debug
817 -- flag d.X.
819 -- d.Z Normally we always enable expansion in configurable run-time mode
820 -- to make sure we get error messages about unsupported features even
821 -- when compiling in -gnatc mode. But expansion is turned off in this
822 -- case if debug flag -gnatd.Z is used. This is to deal with the case
823 -- where we discover difficulties in this new processing.
825 -- d_a The compiler stops the examination of a task body once it reaches
826 -- an accept or select statement for the static elaboration model. The
827 -- behavior is similar to that of No_Entry_Calls_In_Elaboration_Code,
828 -- but does not penalize actual entry calls in elaboration code.
830 -- d_e The compiler ignores simple entry calls, asynchronous transfer of
831 -- control, conditional entry calls, timed entry calls, and requeue
832 -- statements in both the static and dynamic elaboration models.
834 -- d_f Issue info messages related to GNATprove usage to help users
835 -- understand analysis results. By default these are not issued as
836 -- beginners find them confusing. Set automatically by GNATprove when
837 -- switch --info is used.
839 -- d_i The compiler ignores calls and task activations when they target a
840 -- subprogram or task type defined in an external instance for both
841 -- the static and dynamic elaboration models.
843 -- d_p The compiler ignores calls to subprograms which verify the run-time
844 -- semantics of invariants and postconditions in both the static and
845 -- dynamic elaboration models.
847 -- d_s The compiler stops the examination of a task body once it reaches
848 -- a call to routine Ada.Synchronous_Task_Control.Suspend_Until_True
849 -- or Ada.Synchronous_Barriers.Wait_For_Release.
851 -- d_A Do not generate ALI files by setting Opt.Disable_ALI_File.
853 -- d_L Output trace information on elaboration checking. This debug switch
854 -- causes output to be generated showing each call or instantiation as
855 -- it is checked, and the progress of the recursive trace through
856 -- elaboration calls at compile time.
858 -- d1 Error messages have node numbers where possible. Normally error
859 -- messages have only source locations. This option is useful when
860 -- debugging errors caused by expanded code, where the source location
861 -- does not give enough information.
863 -- d2 Suppress output of the error position flags for verbose form error
864 -- messages. The messages are still interspersed in the listing, but
865 -- without any error flags or extra blank lines. Also causes an extra
866 -- <<< to be output at the right margin. This is intended to be the
867 -- easiest format for checking conformance of ACATS B tests. This
868 -- flag also suppresses the additional messages explaining why a
869 -- non-static expression is non-static (see Sem_Eval.Why_Not_Static).
870 -- This avoids having to worry about these messages in ACATS testing.
872 -- d3 Causes Comperr to dump the contents of the node for which an abort
873 -- was detected (normally only the Node_Id of the node is output).
875 -- d4 Inhibits automatic krunching of predefined library unit file names.
876 -- Normally, as described in the spec of package Krunch, such files
877 -- are automatically krunched to 8 characters, with special treatment
878 -- of the prefixes Ada, System, and Interfaces. Setting this debug
879 -- switch disables this special treatment.
881 -- d5 Causes the tree read/write circuit to output detailed information
882 -- tracking the data that is read and written element by element.
884 -- d6 Normally access-to-unconstrained-array types are represented
885 -- using fat (double) pointers. Using this debug flag causes them
886 -- to default to thin. This can be used to test the performance
887 -- implications of using thin pointers, and also to test that the
888 -- compiler functions correctly with this choice.
890 -- d7 Normally a -gnatl or -gnatv listing includes the time stamp of the
891 -- source file and the time of the compilation. This debug flag can
892 -- be used to suppress this output, and also suppresses the message
893 -- with the version of the compiler. This is useful for regression
894 -- tests which need to have consistent output.
896 -- d8 This forces the packed stuff to generate code assuming the
897 -- opposite endianness from the actual correct value. Useful in
898 -- testing out code generation from the packed routines.
900 -- d9 This allows lock free implementation for protected objects
901 -- (see Exp_Ch9).
903 -- d.1 Sets Opt.Unnest_Subprogram_Mode to enable unnesting of subprograms.
904 -- This special pass does not actually unnest things, but it ensures
905 -- that a nested procedure does not contain any uplevel references.
906 -- See spec of Exp_Unst for full details.
908 -- d.2 Allow statements within declarative parts. This is not usually
909 -- allowed, but in some debugging contexts (e.g. testing the circuit
910 -- for unnesting of procedures), it is useful to allow this.
912 -- d.3 Output debugging information from Exp_Unst, including the name of
913 -- any unreachable subprograms that get deleted.
915 -- d.4 By default in case of an error during C generation, the .c or .h
916 -- file is deleted. This flag keeps the C file.
918 -- d.5 By default a subprogram imported generates a subprogram profile.
919 -- This debug flag disables this generation when generating C code,
920 -- assuming a proper #include will be used instead.
922 -- d.6 By default the C back-end avoids declaring types that are not
923 -- referenced by the generated C code. This debug flag restores the
924 -- output of all the types.
926 -- d.7 Indicates (to gnat2scil) that CodePeer is being invoked as a
927 -- prover by the SPARK tools and that therefore gnat2scil should
928 -- avoid SCIL generation strategies which can introduce soundness
929 -- issues (e.g., assuming that a low bound of an array parameter
930 -- of an unconstrained subtype belongs to the index subtype).
932 -- d.9 Enable build-in-place for function calls returning some nonlimited
933 -- types.
935 ------------------------------------------
936 -- Documentation for Binder Debug Flags --
937 ------------------------------------------
939 -- da Normally if there is an elaboration circularity, then in describing
940 -- the cycle, links involving internal units are omitted, since they
941 -- are irrelevant and confusing. This debug flag causes all links to
942 -- be listed, and is useful when diagnosing circularities introduced
943 -- by incorrect changes to the run-time library itself.
945 -- db Output debug information from Better_Choice in Binde, which uses
946 -- various heuristics to determine elaboration order in cases where
947 -- multiple orders are valid.
949 -- dc List units as they are chosen. As units are selected for addition to
950 -- the elaboration order, a line of output is generated showing which
951 -- unit has been selected.
953 -- de Similar to the effect of -e (output complete list of elaboration
954 -- dependencies) except that internal units are included in the
955 -- listing.
957 -- di Normally gnatbind calls Read_Ali with Ignore_Errors set to
958 -- False, since the binder really needs correct version ALI
959 -- files to do its job. This debug flag causes Ignore_Errors
960 -- mode to be set for the binder (and is particularly useful
961 -- for testing ignore errors mode).
963 -- dn List details of manipulation of Num_Pred values during execution of
964 -- the algorithm used to determine a correct order of elaboration. This
965 -- is useful in diagnosing any problems in its behavior.
967 -- do Use older elaboration order preference. The new preference rules
968 -- prefer specs with no bodies to specs with bodies, and between two
969 -- specs with bodies, prefers the one whose body is closer to being
970 -- able to be elaborated. This is a clear improvement, but we provide
971 -- this debug flag in case of regressions. Note: -do is even older
972 -- than -dp.
974 -- dp Use old elaboration order preference. The new preference rules
975 -- elaborate all units within a strongly connected component together,
976 -- with no other units in between. In particular, if a spec/body pair
977 -- can be elaborated together, it will be. In the new order, the binder
978 -- behaves as if every pragma Elaborate_All that would be legal is
979 -- present, even if it does not appear in the source code.
981 -- du List unit name and file name for each unit as it is read in
983 -- dv Verbose debugging printouts
985 -- dx Force the binder to read (and then ignore) the xref information
986 -- in ali files (used to check that read circuit is working OK).
988 --------------------------------------------
989 -- Documentation for gnatmake Debug Flags --
990 --------------------------------------------
992 -- df Only output file names, not path names, in log
994 -- dh Generate listing showing loading of name table hash chains,
995 -- same as for the compiler.
997 -- dm Issue a message indicating the maximum number of simultaneous
998 -- compilations.
1000 -- dn Do not delete temporary files created by gnatmake at the end
1001 -- of execution, such as temporary config pragma files, mapping
1002 -- files or project path files. This debug switch is equivalent to
1003 -- the standard switch --keep-temp-files. We retain the debug switch
1004 -- for back compatibility with past usage.
1006 -- dp Prints the Q used by routine Make.Compile_Sources every time
1007 -- we go around the main compile loop of Make.Compile_Sources
1009 -- dq Prints source files as they are enqueued and dequeued in the Q
1010 -- used by routine Make.Compile_Sources. Useful to figure out the
1011 -- order in which sources are recompiled.
1013 -- dt When a time stamp mismatch has been found for an ALI file,
1014 -- display the source file name, the time stamp expected and
1015 -- the time stamp found.
1017 -- du List unit name and file name for each unit as it is read in
1019 -- dw Prints the list of units withed by the unit currently explored
1020 -- during the main loop of Make.Compile_Sources.
1022 ---------------------------------------------
1023 -- Documentation for gprbuild Debug Flags --
1024 ---------------------------------------------
1026 -- dm Display the maximum number of simultaneous compilations.
1028 -- dn Do not delete temporary files created by gprbuild at the end
1029 -- of execution, such as temporary config pragma files, mapping
1030 -- files or project path files. This debug switch is equivalent to
1031 -- the standard switch --keep-temp-files. We retain the debug switch
1032 -- for back compatibility with past usage.
1034 -- dt When a time stamp mismatch has been found for an ALI file,
1035 -- display the source file name, the time stamp expected and
1036 -- the time stamp found.
1038 --------------------
1039 -- Set_Debug_Flag --
1040 --------------------
1047 begin
1126 else
1184 ---------------------------
1185 -- Set_Dotted_Debug_Flag --
1186 ---------------------------
1193 begin
1272 else
1330 --------------------------------
1331 -- Set_Underscored_Debug_Flag --
1332 --------------------------------
1334 procedure Set_Underscored_Debug_Flag
1337 is
1342 begin
1421 else