111
|
1 ------------------------------------------------------------------------------
|
|
2 -- --
|
|
3 -- GNAT COMPILER COMPONENTS --
|
|
4 -- --
|
|
5 -- D E B U G --
|
|
6 -- --
|
|
7 -- B o d y --
|
|
8 -- --
|
|
9 -- Copyright (C) 1992-2017, 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 ------------------------------------------------------------------------------
|
|
31
|
|
32 package body Debug is
|
|
33
|
|
34 ---------------------------------
|
|
35 -- Summary of Debug Flag Usage --
|
|
36 ---------------------------------
|
|
37
|
|
38 -- Debug flags for compiler (GNAT1)
|
|
39
|
|
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
|
|
66
|
|
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
|
|
93
|
|
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
|
|
120
|
|
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
|
|
147
|
|
148 -- d1 Error msgs have node numbers where possible
|
|
149 -- d2 Eliminate error flags in verbose form error messages
|
|
150 -- d3 Dump bad node in Comperr on an abort
|
|
151 -- d4 Inhibit automatic krunch of predefined library unit files
|
|
152 -- d5 Debug output for tree read/write
|
|
153 -- d6 Default access unconstrained to thin pointers
|
|
154 -- d7 Suppress version/source stamp/compilation time for -gnatv/-gnatl
|
|
155 -- d8 Force opposite endianness in packed stuff
|
|
156 -- d9 Allow lock free implementation
|
|
157
|
|
158 -- d.1 Enable unnesting of nested procedures
|
|
159 -- d.2 Allow statements in declarative part
|
|
160 -- d.3 Output debugging information from Exp_Unst
|
|
161 -- d.4 Do not delete generated C file in case of errors
|
|
162 -- d.5 Do not generate imported subprogram definitions in C code
|
|
163 -- d.6 Do not avoid declaring unreferenced types in C code
|
|
164 -- d.7
|
|
165 -- d.8
|
|
166 -- d.9 Disable build-in-place for nonlimited types
|
|
167
|
|
168 -- Debug flags for binder (GNATBIND)
|
|
169
|
|
170 -- da All links (including internal units) listed if there is a cycle
|
|
171 -- db Output information from Better_Choice
|
|
172 -- dc List units as they are chosen
|
|
173 -- dd
|
|
174 -- de Elaboration dependencies including system units
|
|
175 -- df
|
|
176 -- dg
|
|
177 -- dh
|
|
178 -- di Ignore_Errors mode for reading ali files
|
|
179 -- dj
|
|
180 -- dk
|
|
181 -- dl
|
|
182 -- dm
|
|
183 -- dn List details of manipulation of Num_Pred values
|
|
184 -- do Use older preference for elaboration order
|
|
185 -- dp Use old preference for elaboration order
|
|
186 -- dq
|
|
187 -- dr
|
|
188 -- ds
|
|
189 -- dt
|
|
190 -- du List units as they are acquired
|
|
191 -- dv Verbose debugging printouts
|
|
192 -- dw
|
|
193 -- dx Force binder to read xref information from ali files
|
|
194 -- dy
|
|
195 -- dz
|
|
196
|
|
197 -- Debug flags used in package Make and its clients (e.g. GNATMAKE)
|
|
198
|
|
199 -- da
|
|
200 -- db
|
|
201 -- dc
|
|
202 -- dd
|
|
203 -- de
|
|
204 -- df Only output file names, not path names, in log
|
|
205 -- dg
|
|
206 -- dh Generate listing showing loading of name table hash chains
|
|
207 -- di
|
|
208 -- dj
|
|
209 -- dk
|
|
210 -- dl
|
|
211 -- dm Display the number of maximum simultaneous compilations
|
|
212 -- dn Do not delete temp files created by gnatmake
|
|
213 -- do
|
|
214 -- dp Prints the contents of the Q used by Make.Compile_Sources
|
|
215 -- dq Prints source files as they are enqueued and dequeued
|
|
216 -- dr
|
|
217 -- ds
|
|
218 -- dt Display time stamps when there is a mismatch
|
|
219 -- du List units as their ali files are acquired
|
|
220 -- dv
|
|
221 -- dw Prints the list of units withed by the unit currently explored
|
|
222 -- dx
|
|
223 -- dy
|
|
224 -- dz
|
|
225
|
|
226 --------------------------------------------
|
|
227 -- Documentation for Compiler Debug Flags --
|
|
228 --------------------------------------------
|
|
229
|
|
230 -- da Generate messages tracking semantic analyzer progress. A message
|
|
231 -- is output showing each node as it gets analyzed, expanded,
|
|
232 -- resolved, or evaluated. This option is useful for finding out
|
|
233 -- exactly where a bomb during semantic analysis is occurring.
|
|
234
|
|
235 -- db In Exp_Dbug, certain type names are encoded to include debugging
|
|
236 -- information. This debug switch causes lines to be output showing
|
|
237 -- the encodings used.
|
|
238
|
|
239 -- dc List names of units as they are compiled. One line of output will
|
|
240 -- be generated at the start of compiling each unit (package or
|
|
241 -- subprogram).
|
|
242
|
|
243 -- dd Dynamic allocation of tables messages generated. Each time a
|
|
244 -- table is reallocated, a line is output indicating the expansion.
|
|
245
|
|
246 -- de List the entity table
|
|
247
|
|
248 -- df Full tree/source print (includes withed units). Normally the tree
|
|
249 -- output (dt) or recreated source output (dg,do,ds) includes only
|
|
250 -- the main unit. If df is set, then the output in either case
|
|
251 -- includes all compiled units (see also dg,do,ds,dt). Note that to
|
|
252 -- be effective, this switch must be used in combination with one or
|
|
253 -- more of dt, dg, do or ds.
|
|
254
|
|
255 -- dg Print the source recreated from the generated tree. In the case
|
|
256 -- where the tree has been rewritten this output includes only the
|
|
257 -- generated code, not the original code (see also df,do,ds,dz).
|
|
258 -- This flag differs from -gnatG in that the output also includes
|
|
259 -- non-source generated null statements, and freeze nodes, which
|
|
260 -- are normally omitted in -gnatG mode.
|
|
261
|
|
262 -- dh Generates a table at the end of a compilation showing how the hash
|
|
263 -- table chains built by the Namet package are loaded. This is useful
|
|
264 -- in ensuring that the hashing algorithm (in Namet.Hash) is working
|
|
265 -- effectively with typical sets of program identifiers.
|
|
266
|
|
267 -- di Generate messages for visibility linking/delinking
|
|
268
|
|
269 -- dj Suppress "junk null check" for access parameters. This flag permits
|
|
270 -- Ada programs to pass null parameters to access parameters, and to
|
|
271 -- explicitly check such access values against the null literal.
|
|
272 -- Neither of these is valid Ada, but both were allowed in versions of
|
|
273 -- GNAT before 3.10, so this switch can ease the transition process.
|
|
274
|
|
275 -- dk Immediate kill on abort. Normally on an abort (i.e. a call to
|
|
276 -- Comperr.Compiler_Abort), the GNATBUG message is not given if
|
|
277 -- there is a previous error. This debug switch bypasses this test
|
|
278 -- and gives the message unconditionally (useful for debugging).
|
|
279
|
|
280 -- dl Generate unit load trace messages. A line of traceback output is
|
|
281 -- generated each time a request is made to the library manager to
|
|
282 -- load a new unit.
|
|
283
|
|
284 -- dm Prevent special frontend inlining in GNATprove mode. In some cases,
|
|
285 -- some subprogram calls are inlined in GNATprove mode in order to
|
|
286 -- facilitate formal verification. This debug switch prevents that
|
|
287 -- inlining to happen.
|
|
288
|
|
289 -- dn Generate messages for node/list allocation. Each time a node or
|
|
290 -- list header is allocated, a line of output is generated. Certain
|
|
291 -- other basic tree operations also cause a line of output to be
|
|
292 -- generated. This option is useful in seeing where the parser is
|
|
293 -- blowing up.
|
|
294
|
|
295 -- do Print the source recreated from the generated tree. In the case
|
|
296 -- where the tree has been rewritten, this output includes only the
|
|
297 -- original code, not the generated code (see also df,dg,ds,dz).
|
|
298
|
|
299 -- dp Generate messages for parser scope stack push/pops. A line of
|
|
300 -- output by the parser each time the parser scope stack is either
|
|
301 -- pushed or popped. Useful in debugging situations where the
|
|
302 -- parser scope stack ends up incorrectly synchronized
|
|
303
|
|
304 -- dq In layout version 1.38, 2002/01/12, a circuit was implemented
|
|
305 -- to give decent default alignment to short records that had no
|
|
306 -- specific alignment set. This debug option restores the previous
|
|
307 -- behavior of giving such records poor alignments, typically 1.
|
|
308 -- This may be useful in dealing with transition.
|
|
309
|
|
310 -- dr Generate parser resynchronization messages. Normally the parser
|
|
311 -- resynchronizes quietly. With this debug option, two messages
|
|
312 -- are generated, one when the parser starts a resynchronization
|
|
313 -- skip, and another when it resumes parsing. Useful in debugging
|
|
314 -- inadequate error recovery situations.
|
|
315
|
|
316 -- ds Print the source recreated from the generated tree. In the case
|
|
317 -- where the tree has been rewritten this output includes both the
|
|
318 -- generated code and the original code with the generated code
|
|
319 -- being enlosed in curly brackets (see also df,do,ds,dz)
|
|
320
|
|
321 -- dt Print full tree. The generated tree is output (see also df,dy)
|
|
322
|
|
323 -- du Uncheck categorization pragmas. This debug switch causes the
|
|
324 -- elaboration control pragmas (Pure, Preelaborate, etc.) and the
|
|
325 -- categorization pragmas (Shared_Passive, Remote_Types, etc.) to be
|
|
326 -- ignored, so that normal checks are not made (this is particularly
|
|
327 -- useful for adding temporary debugging code to units that have
|
|
328 -- pragmas that are inconsistent with the debugging code added).
|
|
329
|
|
330 -- dv Output trace of overload resolution. Outputs messages for
|
|
331 -- overload attempts that involve cascaded errors, or where
|
|
332 -- an interpretation is incompatible with the context.
|
|
333
|
|
334 -- dw Write semantic scope stack messages. Each time a scope is created
|
|
335 -- or removed, a message is output (see the Sem_Ch8.Push_Scope and
|
|
336 -- Sem_Ch8.Pop_Scope subprograms).
|
|
337
|
|
338 -- dx Force expansion on, even if no code being generated. Normally the
|
|
339 -- expander is inhibited if no code is generated. This switch forces
|
|
340 -- expansion to proceed normally even if the backend is not being
|
|
341 -- called. This is particularly useful for debugging purposes when
|
|
342 -- using the front-end only version of the compiler (which normally
|
|
343 -- would never do any expansion).
|
|
344
|
|
345 -- dy Print tree of package Standard. Normally the tree print out does
|
|
346 -- not include package Standard, even if the -df switch is set. This
|
|
347 -- switch forces output of the internal tree built for Standard.
|
|
348
|
|
349 -- dz Print source of package Standard. Normally the source print out
|
|
350 -- does not include package Standard, even if the -df switch is set.
|
|
351 -- This switch forces output of the source recreated from the internal
|
|
352 -- tree built for Standard. Note that this differs from -gnatS in
|
|
353 -- that it prints from the actual tree using the normal Sprint
|
|
354 -- circuitry for printing trees.
|
|
355
|
|
356 -- dA Forces output of representation information, including full
|
|
357 -- information for all internal type and object entities, as well
|
|
358 -- as all user defined type and object entities including private
|
|
359 -- and incomplete types. This debug switch also automatically sets
|
|
360 -- the equivalent of -gnatRm.
|
|
361
|
|
362 -- dB Output debug encodings for types and variants. See Exp_Dbug for
|
|
363 -- exact form of the generated output.
|
|
364
|
|
365 -- dC Output trace information showing the decisions made during
|
|
366 -- check suppression activity in unit Checks.
|
|
367
|
|
368 -- dD Delete new elaboration checks. This flag causes GNAT to return
|
|
369 -- to the 3.13a elaboration semantics, and to suppress the fixing
|
|
370 -- of two bugs. The first is in the context of inner routines in
|
|
371 -- dynamic elaboration mode, when the subprogram we are in was
|
|
372 -- called at elaboration time by a unit that was also compiled with
|
|
373 -- dynamic elaboration checks. In this case, if A calls B calls C,
|
|
374 -- and all are in different units, we need an elaboration check at
|
|
375 -- each call. These nested checks were only put in recently (see
|
|
376 -- version 1.80 of Sem_Elab) and we provide this debug flag to
|
|
377 -- revert to the previous behavior in case of regressions. The
|
|
378 -- other behavior reverted by this flag is the treatment of the
|
|
379 -- Elaborate_Body pragma in static elaboration mode. This used to
|
|
380 -- be treated as not needing elaboration checking, but in fact in
|
|
381 -- general Elaborate_All is still required because of nested calls.
|
|
382
|
|
383 -- dE Apply compile time elaboration checking for with relations between
|
|
384 -- predefined units. Normally no checks are made.
|
|
385
|
|
386 -- dF Perform the new SPARK checking rules for pointer aliasing. This is
|
|
387 -- only activated in GNATprove mode and on SPARK code. These rules are
|
|
388 -- not yet part of the official SPARK language, but are expected to be
|
|
389 -- included in a future version of SPARK.
|
|
390
|
|
391 -- dG Generate all warnings. Normally Errout suppresses warnings on
|
|
392 -- units that are not part of the main extended source, and also
|
|
393 -- suppresses warnings on instantiations in the main extended
|
|
394 -- source that duplicate warnings already posted on the template.
|
|
395 -- This switch stops both kinds of deletion and causes Errout to
|
|
396 -- post all warnings sent to it.
|
|
397
|
|
398 -- dH Inhibit call to gigi. This is useful for testing front end data
|
|
399 -- layout, and may be useful in other debugging situations where
|
|
400 -- you do not want gigi to intefere with the testing.
|
|
401
|
|
402 -- dI Inhibit internal name numbering in gnatDG listing. Any sequence of
|
|
403 -- the form <uppercase-letter><digits><lowercase-letter> appearing in
|
|
404 -- a name is replaced by <uppercase-letter>...<lowercase-letter>. This
|
|
405 -- is used in the fixed bugs run to minimize system and version
|
|
406 -- dependency in filed -gnatD or -gnatG output.
|
|
407
|
|
408 -- dJ Prepend the name of the enclosing subprogram in compiler messages
|
|
409 -- (errors, warnings, style checks). This is useful in particular to
|
|
410 -- integrate compiler warnings in static analysis tools such as
|
|
411 -- CodePeer.
|
|
412
|
|
413 -- dK Kill all error messages. This debug flag suppresses the output
|
|
414 -- of all error messages. It is used in regression tests where the
|
|
415 -- error messages are target dependent and irrelevant.
|
|
416
|
|
417 -- dL The compiler ignores calls in instances and invoke subprograms
|
|
418 -- which are external to the instance for the static elaboration
|
|
419 -- model. This switch is orthogonal to d.G.
|
|
420
|
|
421 -- dM Assume all variables have been modified, and ignore current value
|
|
422 -- indications. This debug flag disconnects the tracking of constant
|
|
423 -- values (see Exp_Ch2.Expand_Current_Value).
|
|
424
|
|
425 -- dN Do not generate file name information in exception messages
|
|
426
|
|
427 -- dO Output immediate error messages. This causes error messages to
|
|
428 -- be output as soon as they are generated (disconnecting several
|
|
429 -- circuits for improvement of messages, deletion of duplicate
|
|
430 -- messages etc). Useful to diagnose compiler bombs caused by
|
|
431 -- erroneous handling of error situations
|
|
432
|
|
433 -- dP Do not check for controlled objects in preelaborable packages.
|
|
434 -- RM 10.2.1(9) forbids the use of library level controlled objects
|
|
435 -- in preelaborable packages, but this restriction is a huge pain,
|
|
436 -- especially in the predefined library units.
|
|
437
|
|
438 -- dQ Use old method for determining what goes on the secondary stack.
|
|
439 -- This disables some newer optimizations. The intent is to use this
|
|
440 -- temporarily to measure before/after efficiency. ???Remove this
|
|
441 -- when we are done (see Sem_Util.Requires_Transient_Scope).
|
|
442
|
|
443 -- dR Bypass the check for a proper version of s-rpc being present
|
|
444 -- to use the -gnatz? switch. This allows debugging of the use
|
|
445 -- of stubs generation without needing to have GLADE (or some
|
|
446 -- other PCS installed).
|
|
447
|
|
448 -- dS Omit conversion of fpt numbers to exact machine numbers in
|
|
449 -- non-static evaluation contexts (see Check_Non_Static_Context).
|
|
450 -- This is intended for testing out timing problems with this
|
|
451 -- conversion circuit.
|
|
452
|
|
453 -- dT Similar to dS, but omits the conversions only in the case where
|
|
454 -- the parent is not a constant declaration.
|
|
455
|
|
456 -- dU Enable garbage collection of unreachable entities. This enables
|
|
457 -- both the reachability analysis and changing the Is_Public and
|
|
458 -- Is_Eliminated flags.
|
|
459
|
|
460 -- dV Enable viewing of all symbols in debugger. Causes debug information
|
|
461 -- to be generated for all symbols, including internal symbols. This
|
|
462 -- is enabled by default for -gnatD, but this switch allows this to
|
|
463 -- be enabled without generating modified source files. Note that the
|
|
464 -- use of -gnatdV ensures in the dwarf/elf case that all symbols that
|
|
465 -- are present in the elf tables are also in the dwarf tables (which
|
|
466 -- seems to be required by some tools). Another effect of dV is to
|
|
467 -- generate full qualified names, including internal names generated
|
|
468 -- for blocks and loops.
|
|
469
|
|
470 -- dW Disable warnings when a possibly uninitialized scalar value is
|
|
471 -- passed to an IN OUT parameter of a procedure. This usage is a
|
|
472 -- quite improper bounded error [erroneous in Ada 83] situation,
|
|
473 -- and would normally generate a warning. However, to ease the
|
|
474 -- task of transitioning incorrect legacy code, we provide this
|
|
475 -- undocumented feature for suppressing these warnings.
|
|
476
|
|
477 -- dY Enable configurable run-time mode, just as though the System file
|
|
478 -- had Configurable_Run_Time_Mode set to True. This is useful in
|
|
479 -- testing high integrity mode.
|
|
480
|
|
481 -- dZ Generate listing showing the contents of the dispatch tables. Each
|
|
482 -- line has an internally generated number used for references between
|
|
483 -- tagged types and primitives. For each primitive the output has the
|
|
484 -- following fields:
|
|
485 --
|
|
486 -- - Letter 'P' or letter 's': The former indicates that this
|
|
487 -- primitive will be located in a primary dispatch table. The
|
|
488 -- latter indicates that it will be located in a secondary
|
|
489 -- dispatch table.
|
|
490 --
|
|
491 -- - Name of the primitive. In case of predefined Ada primitives
|
|
492 -- the text "(predefined)" is added before the name, and these
|
|
493 -- acronyms are used: SR (Stream_Read), SW (Stream_Write), SI
|
|
494 -- (Stream_Input), SO (Stream_Output), DA (Deep_Adjust), DF
|
|
495 -- (Deep_Finalize). In addition Oeq identifies the equality
|
|
496 -- operator, and "_assign" the assignment.
|
|
497 --
|
|
498 -- - If the primitive covers interface types, two extra fields
|
|
499 -- referencing other primitives are generated: "Alias" references
|
|
500 -- the primitive of the tagged type that covers an interface
|
|
501 -- primitive, and "AI_Alias" references the covered interface
|
|
502 -- primitive.
|
|
503 --
|
|
504 -- - The expression "at #xx" indicates the slot of the dispatch
|
|
505 -- table occupied by such primitive in its corresponding primary
|
|
506 -- or secondary dispatch table.
|
|
507 --
|
|
508 -- - In case of abstract subprograms the text "is abstract" is
|
|
509 -- added at the end of the line.
|
|
510
|
|
511 -- d.a Force Target_Strict_Alignment to True, even on targets where it
|
|
512 -- would normally be false. Can be used for testing strict alignment
|
|
513 -- circuitry in the compiler.
|
|
514
|
|
515 -- d.b Dump back end types. During Create_Standard, the back end is
|
|
516 -- queried for all available types. This option shows them.
|
|
517
|
|
518 -- d.c Generate inline concatenation, instead of calling one of the
|
|
519 -- System.Concat_n.Str_Concat_n routines in cases where the latter
|
|
520 -- routines would normally be called.
|
|
521
|
|
522 -- d.d Disable atomic synchronization for all atomic variable references.
|
|
523 -- Pragma Enable_Atomic_Synchronization is ignored.
|
|
524
|
|
525 -- d.e Enable atomic synchronization for all atomic variable references.
|
|
526 -- Pragma Disable_Atomic_Synchronization is ignored, and also the
|
|
527 -- compiler switch -gnated is ignored.
|
|
528
|
|
529 -- d.f Suppress folding of static expressions. This of course results
|
|
530 -- in seriously non-conforming behavior, but is useful sometimes
|
|
531 -- when tracking down handling of complex expressions.
|
|
532
|
|
533 -- d.g Enables conversion of a raise statement into a goto when the
|
|
534 -- relevant handler is statically determinable. For now we only try
|
|
535 -- this if this debug flag is set. Later we will enable this more
|
|
536 -- generally by default.
|
|
537
|
|
538 -- d.h Minimize the creation of public internal symbols for concatenation
|
|
539 -- by enforcing a secondary stack-like handling of the final result.
|
|
540 -- The target of the concatenation is thus constrained in place and
|
|
541 -- initialized with the result instead of acting as its alias.
|
|
542
|
|
543 -- d.i Ignore all occurrences of pragma Warnings in the sources. This can
|
|
544 -- be used in particular to disable Warnings (Off) to check if any of
|
|
545 -- these statements are inappropriate.
|
|
546
|
|
547 -- d.k If an error message contains a reference to a location in an
|
|
548 -- internal unit, then suppress the line number in this reference.
|
|
549
|
|
550 -- d.j Generate listing of frontend inlined calls and inline calls passed
|
|
551 -- to the backend. This is useful to locate skipped calls that must be
|
|
552 -- inlined by the frontend.
|
|
553
|
|
554 -- d.l Use Ada 95 semantics for limited function returns. This may be
|
|
555 -- used to work around the incompatibility introduced by AI-318-2.
|
|
556 -- It is useful only in Ada 2005 and later.
|
|
557
|
|
558 -- d.m When -gnatl is used, the normal output includes full listings of
|
|
559 -- all files in the extended main source (body/spec/subunits). If this
|
|
560 -- debug switch is used, then the full listing is given only for the
|
|
561 -- main source (this corresponds to a previous behavior of -gnatl and
|
|
562 -- is used for running the ACATS tests).
|
|
563
|
|
564 -- d.n Print source file names as they are loaded. This is useful if the
|
|
565 -- compiler has a bug -- these are the files that need to be included
|
|
566 -- in a bug report.
|
|
567
|
|
568 -- d.o Conservative elaboration order for indirect calls. This causes
|
|
569 -- P'Access to be treated as a call in more cases.
|
|
570
|
|
571 -- d.p In Ada 95 (or 83) mode, use original Ada 95 behavior for the
|
|
572 -- interpretation of component clauses crossing byte boundaries when
|
|
573 -- using the non-default bit order (i.e. ignore AI95-0133).
|
|
574
|
|
575 -- d.q If an array variable or constant is not modified in Ada code, and
|
|
576 -- is passed to an 'in' parameter of a foreign-convention subprogram,
|
|
577 -- and that subprogram modifies the array, the Ada compiler normally
|
|
578 -- assumes that the array is not modified. This option suppresses such
|
|
579 -- optimizations. This option should not be used; the correct solution
|
|
580 -- is to declare the parameter 'in out'.
|
|
581
|
|
582 -- d.r Do not reorder components in record types.
|
|
583
|
|
584 -- d.s The compiler no longer attempts to optimize the calls to secondary
|
|
585 -- stack management routines SS_Mark and SS_Release. As a result, each
|
|
586 -- transient block tasked with secondary stack management will fulfill
|
|
587 -- its role unconditionally.
|
|
588
|
|
589 -- d.s The compiler does not generate calls to secondary stack management
|
|
590 -- routines SS_Mark and SS_Release for a transient block when there is
|
|
591 -- an enclosing scoping construct which already manages the secondary
|
|
592 -- stack.
|
|
593
|
|
594 -- d.t The compiler has been modified (a fairly extensive modification)
|
|
595 -- to generate static dispatch tables for library level tagged types.
|
|
596 -- This debug switch disables this modification and reverts to the
|
|
597 -- previous dynamic construction of tables. It is there as a possible
|
|
598 -- work around if we run into trouble with the new implementation.
|
|
599
|
|
600 -- d.u Sets Modify_Tree_For_C mode in which tree is modified to make it
|
|
601 -- easier to generate code using a C compiler.
|
|
602
|
|
603 -- d.v This flag enforces the elaboration rules defined in the SPARK
|
|
604 -- Reference Manual, chapter 7.7, to all SPARK code within a unit. As
|
|
605 -- a result, constructs which violate the rules in chapter 7.7 are no
|
|
606 -- longer accepted, even if the implementation is able to statically
|
|
607 -- ensure that accepting these constructs does not introduce the
|
|
608 -- possibility of failing an elaboration check.
|
|
609
|
|
610 -- d.w This flag turns off the scanning of loops to detect possible
|
|
611 -- infinite loops.
|
|
612
|
|
613 -- d.x No exception handlers in generated code. This causes exception
|
|
614 -- handlers to be eliminated from the generated code. They are still
|
|
615 -- fully compiled and analyzed, they just get eliminated from the
|
|
616 -- code generation step.
|
|
617
|
|
618 -- d.y Disable implicit pragma Elaborate_All on task bodies. When a task
|
|
619 -- body calls a procedure in the same package, and that procedure
|
|
620 -- calls a procedure in another package, the static elaboration
|
|
621 -- machinery adds an implicit Elaborate_All on the other package. This
|
|
622 -- switch disables the addition of the implicit pragma in such cases.
|
|
623
|
|
624 -- d.z Restore previous front-end support for Inline_Always. In default
|
|
625 -- mode, for targets that use the GCC back end, Inline_Always is
|
|
626 -- handled by the back end. Use of this switch restores the previous
|
|
627 -- handling of Inline_Always by the front end on such targets. For the
|
|
628 -- targets that do not use the GCC back end, this switch is ignored.
|
|
629
|
|
630 -- d.A There seems to be a problem with ASIS if we activate the circuit
|
|
631 -- for reading and writing the aspect specification hash table, so
|
|
632 -- for now, this is controlled by the debug flag d.A. The hash table
|
|
633 -- is only written and read if this flag is set.
|
|
634
|
|
635 -- d.B Generate a bug box when we see an abort_statement, even though
|
|
636 -- there is no bug. Useful for testing Comperr.Compiler_Abort: write
|
|
637 -- some code containing an abort_statement, and compile it with
|
|
638 -- -gnatd.B. There is nothing special about abort_statements; it just
|
|
639 -- provides a way to control where the bug box is generated. See "when
|
|
640 -- N_Abort_Statement" in package body Expander.
|
|
641
|
|
642 -- d.C Generate call to System.Concat_n.Str_Concat_n routines in cases
|
|
643 -- where we would normally generate inline concatenation code.
|
|
644
|
|
645 -- d.D For compatibility with some Ada 95 compilers implementing only
|
|
646 -- one feature of Ada 2005 (overriding keyword), disable errors on use
|
|
647 -- of overriding keyword in Ada 95 mode.
|
|
648
|
|
649 -- d.E Turn selected errors into warnings. This debug switch causes a
|
|
650 -- specific set of error messages into warnings. Setting this switch
|
|
651 -- causes Opt.Error_To_Warning to be set to True. The intention is
|
|
652 -- that this be used for messages representing upwards incompatible
|
|
653 -- changes to Ada 2012 that cause previously correct programs to be
|
|
654 -- treated as illegal now. The following cases are affected:
|
|
655 --
|
|
656 -- Errors relating to overlapping subprogram parameters for cases
|
|
657 -- other than IN OUT parameters to functions.
|
|
658 --
|
|
659 -- Errors relating to the new rules about not defining equality
|
|
660 -- too late so that composition of equality can be assured.
|
|
661 --
|
|
662 -- Errors relating to overriding indicators on protected subprogram
|
|
663 -- bodies (not an Ada 2012 incompatibility, but might cause errors
|
|
664 -- for existing programs assuming they were legal because GNAT
|
|
665 -- formerly allowed them).
|
|
666
|
|
667 -- d.F Sets GNATprove_Mode to True. This allows debugging the frontend in
|
|
668 -- the special mode used by GNATprove.
|
|
669
|
|
670 -- d.G Previously the compiler ignored calls via generic formal parameters
|
|
671 -- when doing the analysis for the static elaboration model. This is
|
|
672 -- now fixed, but we provide this debug flag to revert to the previous
|
|
673 -- situation of ignoring such calls to aid in transition. This switch
|
|
674 -- is orthogonal to dL.
|
|
675
|
|
676 -- d.H Sets ASIS_GNSA_Mode to True. This signals the front end to suppress
|
|
677 -- the call to gigi in ASIS_Mode.
|
|
678
|
|
679 -- d.I Do not ignore enum representation clauses in CodePeer mode.
|
|
680 -- The default of ignoring representation clauses for enumeration
|
|
681 -- types in CodePeer is good for the majority of Ada code, but in some
|
|
682 -- cases being able to change this default might be useful to remove
|
|
683 -- some false positives.
|
|
684
|
|
685 -- d.J Relaxed rules for pragma No_Return. A pragma No_Return is illegal
|
|
686 -- if it applies to a body. This switch disables the legality check
|
|
687 -- for that. If the procedure does in fact return normally, execution
|
|
688 -- is erroneous, and therefore unpredictable.
|
|
689
|
|
690 -- d.K Enable generation of contract-only procedures in CodePeer mode and
|
|
691 -- report a warning on subprograms for which the contract-only body
|
|
692 -- cannot be built. Currently reported on subprograms defined in
|
|
693 -- nested package specs that have some formal (or return type) whose
|
|
694 -- type is a private type defined in some enclosing package and that
|
|
695 -- have pre/postconditions.
|
|
696
|
|
697 -- d.L Normally the front end generates special expansion for conditional
|
|
698 -- expressions of a limited type. This debug flag removes this special
|
|
699 -- case expansion, leaving it up to the back end to handle conditional
|
|
700 -- expressions correctly.
|
|
701
|
|
702 -- d.M Relaxed RM semantics. This flag sets Opt.Relaxed_RM_Semantics
|
|
703 -- See Opt.Relaxed_RM_Semantics for more details.
|
|
704
|
|
705 -- d.N Enlarge entities by one node (but don't attempt to use this extra
|
|
706 -- node for storage of any flags or fields). This can be used to do
|
|
707 -- experiments on the impact of increasing entity sizes.
|
|
708
|
|
709 -- d.O Dump internal SCO tables. Before outputting the SCO information to
|
|
710 -- the ALI file, the internal SCO tables (SCO_Table/SCO_Unit_Table)
|
|
711 -- are dumped for debugging purposes.
|
|
712
|
|
713 -- d.P Previous non-optimized handling of length comparisons. Setting this
|
|
714 -- flag inhibits the effect of Optimize_Length_Comparison in Exp_Ch4.
|
|
715 -- This is there in case we find a situation where the optimization
|
|
716 -- malfunctions, to provide a work around.
|
|
717
|
|
718 -- d.Q Previous incomplete style checks for binary operators. Style checks
|
|
719 -- for token separation rules were incomplete and have been made
|
|
720 -- compliant with the documentation. For example, no warning was
|
|
721 -- issued for expressions such as 16-One or "A"&"B". Setting this flag
|
|
722 -- inhibits these new checks.
|
|
723
|
|
724 -- d.R As documented in lib-writ.ads, restrictions in the ali file can
|
|
725 -- have two forms, positional and named. The named notation is the
|
|
726 -- current preferred form, but the use of this debug switch will force
|
|
727 -- the use of the obsolescent positional form.
|
|
728
|
|
729 -- d.S Force Optimize_Alignment (Space) mode as the default
|
|
730
|
|
731 -- d.T Force Optimize_Alignment (Time) mode as the default
|
|
732
|
|
733 -- d.U Ignore indirect calls for static elaboration. The static
|
|
734 -- elaboration model is conservative, especially regarding indirect
|
|
735 -- calls. If you say Proc'Access, it will assume you might call
|
|
736 -- Proc. This can cause elaboration cycles at bind time. This flag
|
|
737 -- reverts to the behavior of earlier compilers, which ignored
|
|
738 -- indirect calls.
|
|
739
|
|
740 -- d.V Do not verify the validity of SCIL files (CodePeer mode). When
|
|
741 -- generating SCIL files for CodePeer, by default we verify that the
|
|
742 -- SCIL is well formed before saving it on disk. This switch can be
|
|
743 -- used to disable this checking, either to improve speed or to shut
|
|
744 -- down a false positive detected during the verification.
|
|
745
|
|
746 -- d.W Print out debugging information for Walk_Library_Items, including
|
|
747 -- the order in which units are walked. This is primarily for use in
|
|
748 -- debugging CodePeer mode.
|
|
749
|
|
750 -- d.X A previous version of GNAT allowed indexing aspects to be redefined
|
|
751 -- on derived container types, while the default iterator was
|
|
752 -- inherited from the parent type. This nonstandard extension is
|
|
753 -- preserved temporarily for use by the modeling project under debug
|
|
754 -- flag d.X.
|
|
755
|
|
756 -- d.Z Normally we always enable expansion in configurable run-time mode
|
|
757 -- to make sure we get error messages about unsupported features even
|
|
758 -- when compiling in -gnatc mode. But expansion is turned off in this
|
|
759 -- case if debug flag -gnatd.Z is used. This is to deal with the case
|
|
760 -- where we discover difficulties in this new processing.
|
|
761
|
|
762 -- d1 Error messages have node numbers where possible. Normally error
|
|
763 -- messages have only source locations. This option is useful when
|
|
764 -- debugging errors caused by expanded code, where the source location
|
|
765 -- does not give enough information.
|
|
766
|
|
767 -- d2 Suppress output of the error position flags for verbose form error
|
|
768 -- messages. The messages are still interspersed in the listing, but
|
|
769 -- without any error flags or extra blank lines. Also causes an extra
|
|
770 -- <<< to be output at the right margin. This is intended to be the
|
|
771 -- easiest format for checking conformance of ACATS B tests. This
|
|
772 -- flag also suppresses the additional messages explaining why a
|
|
773 -- non-static expression is non-static (see Sem_Eval.Why_Not_Static).
|
|
774 -- This avoids having to worry about these messages in ACATS testing.
|
|
775
|
|
776 -- d3 Causes Comperr to dump the contents of the node for which an abort
|
|
777 -- was detected (normally only the Node_Id of the node is output).
|
|
778
|
|
779 -- d4 Inhibits automatic krunching of predefined library unit file names.
|
|
780 -- Normally, as described in the spec of package Krunch, such files
|
|
781 -- are automatically krunched to 8 characters, with special treatment
|
|
782 -- of the prefixes Ada, System, and Interfaces. Setting this debug
|
|
783 -- switch disables this special treatment.
|
|
784
|
|
785 -- d5 Causes the tree read/write circuit to output detailed information
|
|
786 -- tracking the data that is read and written element by element.
|
|
787
|
|
788 -- d6 Normally access-to-unconstrained-array types are represented
|
|
789 -- using fat (double) pointers. Using this debug flag causes them
|
|
790 -- to default to thin. This can be used to test the performance
|
|
791 -- implications of using thin pointers, and also to test that the
|
|
792 -- compiler functions correctly with this choice.
|
|
793
|
|
794 -- d7 Normally a -gnatl or -gnatv listing includes the time stamp of the
|
|
795 -- source file and the time of the compilation. This debug flag can
|
|
796 -- be used to suppress this output, and also suppresses the message
|
|
797 -- with the version of the compiler. This is useful for regression
|
|
798 -- tests which need to have consistent output.
|
|
799
|
|
800 -- d8 This forces the packed stuff to generate code assuming the
|
|
801 -- opposite endianness from the actual correct value. Useful in
|
|
802 -- testing out code generation from the packed routines.
|
|
803
|
|
804 -- d9 This allows lock free implementation for protected objects
|
|
805 -- (see Exp_Ch9).
|
|
806
|
|
807 -- d.1 Sets Opt.Unnest_Subprogram_Mode to enable unnesting of subprograms.
|
|
808 -- This special pass does not actually unnest things, but it ensures
|
|
809 -- that a nested procedure does not contain any uplevel references.
|
|
810 -- See spec of Exp_Unst for full details.
|
|
811
|
|
812 -- d.2 Allow statements within declarative parts. This is not usually
|
|
813 -- allowed, but in some debugging contexts (e.g. testing the circuit
|
|
814 -- for unnesting of procedures), it is useful to allow this.
|
|
815
|
|
816 -- d.3 Output debugging information from Exp_Unst, including the name of
|
|
817 -- any unreachable subprograms that get deleted.
|
|
818
|
|
819 -- d.4 By default in case of an error during C generation, the .c or .h
|
|
820 -- file is deleted. This flag keeps the C file.
|
|
821
|
|
822 -- d.5 By default a subprogram imported generates a subprogram profile.
|
|
823 -- This debug flag disables this generation when generating C code,
|
|
824 -- assuming a proper #include will be used instead.
|
|
825
|
|
826 -- d.6 By default the C back-end avoids declaring types that are not
|
|
827 -- referenced by the generated C code. This debug flag restores the
|
|
828 -- output of all the types.
|
|
829
|
|
830 -- d.9 Enable build-in-place for function calls returning some nonlimited
|
|
831 -- types.
|
|
832
|
|
833 ------------------------------------------
|
|
834 -- Documentation for Binder Debug Flags --
|
|
835 ------------------------------------------
|
|
836
|
|
837 -- da Normally if there is an elaboration circularity, then in describing
|
|
838 -- the cycle, links involving internal units are omitted, since they
|
|
839 -- are irrelevant and confusing. This debug flag causes all links to
|
|
840 -- be listed, and is useful when diagnosing circularities introduced
|
|
841 -- by incorrect changes to the run-time library itself.
|
|
842
|
|
843 -- db Output debug information from Better_Choice in Binde, which uses
|
|
844 -- various heuristics to determine elaboration order in cases where
|
|
845 -- multiple orders are valid.
|
|
846
|
|
847 -- dc List units as they are chosen. As units are selected for addition to
|
|
848 -- the elaboration order, a line of output is generated showing which
|
|
849 -- unit has been selected.
|
|
850
|
|
851 -- de Similar to the effect of -e (output complete list of elaboration
|
|
852 -- dependencies) except that internal units are included in the
|
|
853 -- listing.
|
|
854
|
|
855 -- di Normally gnatbind calls Read_Ali with Ignore_Errors set to
|
|
856 -- False, since the binder really needs correct version ALI
|
|
857 -- files to do its job. This debug flag causes Ignore_Errors
|
|
858 -- mode to be set for the binder (and is particularly useful
|
|
859 -- for testing ignore errors mode).
|
|
860
|
|
861 -- dn List details of manipulation of Num_Pred values during execution of
|
|
862 -- the algorithm used to determine a correct order of elaboration. This
|
|
863 -- is useful in diagnosing any problems in its behavior.
|
|
864
|
|
865 -- do Use older elaboration order preference. The new preference rules
|
|
866 -- prefer specs with no bodies to specs with bodies, and between two
|
|
867 -- specs with bodies, prefers the one whose body is closer to being
|
|
868 -- able to be elaborated. This is a clear improvement, but we provide
|
|
869 -- this debug flag in case of regressions. Note: -do is even older
|
|
870 -- than -dp.
|
|
871
|
|
872 -- dp Use old elaboration order preference. The new preference rules
|
|
873 -- elaborate all units within a strongly connected component together,
|
|
874 -- with no other units in between. In particular, if a spec/body pair
|
|
875 -- can be elaborated together, it will be. In the new order, the binder
|
|
876 -- behaves as if every pragma Elaborate_All that would be legal is
|
|
877 -- present, even if it does not appear in the source code.
|
|
878
|
|
879 -- du List unit name and file name for each unit as it is read in
|
|
880
|
|
881 -- dv Verbose debugging printouts
|
|
882
|
|
883 -- dx Force the binder to read (and then ignore) the xref information
|
|
884 -- in ali files (used to check that read circuit is working OK).
|
|
885
|
|
886 --------------------------------------------
|
|
887 -- Documentation for gnatmake Debug Flags --
|
|
888 --------------------------------------------
|
|
889
|
|
890 -- df Only output file names, not path names, in log
|
|
891
|
|
892 -- dh Generate listing showing loading of name table hash chains,
|
|
893 -- same as for the compiler.
|
|
894
|
|
895 -- dm Issue a message indicating the maximum number of simultaneous
|
|
896 -- compilations.
|
|
897
|
|
898 -- dn Do not delete temporary files created by gnatmake at the end
|
|
899 -- of execution, such as temporary config pragma files, mapping
|
|
900 -- files or project path files. This debug switch is equivalent to
|
|
901 -- the standard switch --keep-temp-files. We retain the debug switch
|
|
902 -- for back compatibility with past usage.
|
|
903
|
|
904 -- dp Prints the Q used by routine Make.Compile_Sources every time
|
|
905 -- we go around the main compile loop of Make.Compile_Sources
|
|
906
|
|
907 -- dq Prints source files as they are enqueued and dequeued in the Q
|
|
908 -- used by routine Make.Compile_Sources. Useful to figure out the
|
|
909 -- order in which sources are recompiled.
|
|
910
|
|
911 -- dt When a time stamp mismatch has been found for an ALI file,
|
|
912 -- display the source file name, the time stamp expected and
|
|
913 -- the time stamp found.
|
|
914
|
|
915 -- du List unit name and file name for each unit as it is read in
|
|
916
|
|
917 -- dw Prints the list of units withed by the unit currently explored
|
|
918 -- during the main loop of Make.Compile_Sources.
|
|
919
|
|
920 ---------------------------------------------
|
|
921 -- Documentation for gprbuild Debug Flags --
|
|
922 ---------------------------------------------
|
|
923
|
|
924 -- dm Display the maximum number of simultaneous compilations.
|
|
925
|
|
926 -- dn Do not delete temporary files created by gprbuild at the end
|
|
927 -- of execution, such as temporary config pragma files, mapping
|
|
928 -- files or project path files. This debug switch is equivalent to
|
|
929 -- the standard switch --keep-temp-files. We retain the debug switch
|
|
930 -- for back compatibility with past usage.
|
|
931
|
|
932 -- dt When a time stamp mismatch has been found for an ALI file,
|
|
933 -- display the source file name, the time stamp expected and
|
|
934 -- the time stamp found.
|
|
935
|
|
936 --------------------
|
|
937 -- Set_Debug_Flag --
|
|
938 --------------------
|
|
939
|
|
940 procedure Set_Debug_Flag (C : Character; Val : Boolean := True) is
|
|
941 subtype Dig is Character range '1' .. '9';
|
|
942 subtype LLet is Character range 'a' .. 'z';
|
|
943 subtype ULet is Character range 'A' .. 'Z';
|
|
944
|
|
945 begin
|
|
946 if C in Dig then
|
|
947 case Dig (C) is
|
|
948 when '1' =>
|
|
949 Debug_Flag_1 := Val;
|
|
950 when '2' =>
|
|
951 Debug_Flag_2 := Val;
|
|
952 when '3' =>
|
|
953 Debug_Flag_3 := Val;
|
|
954 when '4' =>
|
|
955 Debug_Flag_4 := Val;
|
|
956 when '5' =>
|
|
957 Debug_Flag_5 := Val;
|
|
958 when '6' =>
|
|
959 Debug_Flag_6 := Val;
|
|
960 when '7' =>
|
|
961 Debug_Flag_7 := Val;
|
|
962 when '8' =>
|
|
963 Debug_Flag_8 := Val;
|
|
964 when '9' =>
|
|
965 Debug_Flag_9 := Val;
|
|
966 end case;
|
|
967
|
|
968 elsif C in ULet then
|
|
969 case ULet (C) is
|
|
970 when 'A' =>
|
|
971 Debug_Flag_AA := Val;
|
|
972 when 'B' =>
|
|
973 Debug_Flag_BB := Val;
|
|
974 when 'C' =>
|
|
975 Debug_Flag_CC := Val;
|
|
976 when 'D' =>
|
|
977 Debug_Flag_DD := Val;
|
|
978 when 'E' =>
|
|
979 Debug_Flag_EE := Val;
|
|
980 when 'F' =>
|
|
981 Debug_Flag_FF := Val;
|
|
982 when 'G' =>
|
|
983 Debug_Flag_GG := Val;
|
|
984 when 'H' =>
|
|
985 Debug_Flag_HH := Val;
|
|
986 when 'I' =>
|
|
987 Debug_Flag_II := Val;
|
|
988 when 'J' =>
|
|
989 Debug_Flag_JJ := Val;
|
|
990 when 'K' =>
|
|
991 Debug_Flag_KK := Val;
|
|
992 when 'L' =>
|
|
993 Debug_Flag_LL := Val;
|
|
994 when 'M' =>
|
|
995 Debug_Flag_MM := Val;
|
|
996 when 'N' =>
|
|
997 Debug_Flag_NN := Val;
|
|
998 when 'O' =>
|
|
999 Debug_Flag_OO := Val;
|
|
1000 when 'P' =>
|
|
1001 Debug_Flag_PP := Val;
|
|
1002 when 'Q' =>
|
|
1003 Debug_Flag_QQ := Val;
|
|
1004 when 'R' =>
|
|
1005 Debug_Flag_RR := Val;
|
|
1006 when 'S' =>
|
|
1007 Debug_Flag_SS := Val;
|
|
1008 when 'T' =>
|
|
1009 Debug_Flag_TT := Val;
|
|
1010 when 'U' =>
|
|
1011 Debug_Flag_UU := Val;
|
|
1012 when 'V' =>
|
|
1013 Debug_Flag_VV := Val;
|
|
1014 when 'W' =>
|
|
1015 Debug_Flag_WW := Val;
|
|
1016 when 'X' =>
|
|
1017 Debug_Flag_XX := Val;
|
|
1018 when 'Y' =>
|
|
1019 Debug_Flag_YY := Val;
|
|
1020 when 'Z' =>
|
|
1021 Debug_Flag_ZZ := Val;
|
|
1022 end case;
|
|
1023
|
|
1024 else
|
|
1025 case LLet (C) is
|
|
1026 when 'a' =>
|
|
1027 Debug_Flag_A := Val;
|
|
1028 when 'b' =>
|
|
1029 Debug_Flag_B := Val;
|
|
1030 when 'c' =>
|
|
1031 Debug_Flag_C := Val;
|
|
1032 when 'd' =>
|
|
1033 Debug_Flag_D := Val;
|
|
1034 when 'e' =>
|
|
1035 Debug_Flag_E := Val;
|
|
1036 when 'f' =>
|
|
1037 Debug_Flag_F := Val;
|
|
1038 when 'g' =>
|
|
1039 Debug_Flag_G := Val;
|
|
1040 when 'h' =>
|
|
1041 Debug_Flag_H := Val;
|
|
1042 when 'i' =>
|
|
1043 Debug_Flag_I := Val;
|
|
1044 when 'j' =>
|
|
1045 Debug_Flag_J := Val;
|
|
1046 when 'k' =>
|
|
1047 Debug_Flag_K := Val;
|
|
1048 when 'l' =>
|
|
1049 Debug_Flag_L := Val;
|
|
1050 when 'm' =>
|
|
1051 Debug_Flag_M := Val;
|
|
1052 when 'n' =>
|
|
1053 Debug_Flag_N := Val;
|
|
1054 when 'o' =>
|
|
1055 Debug_Flag_O := Val;
|
|
1056 when 'p' =>
|
|
1057 Debug_Flag_P := Val;
|
|
1058 when 'q' =>
|
|
1059 Debug_Flag_Q := Val;
|
|
1060 when 'r' =>
|
|
1061 Debug_Flag_R := Val;
|
|
1062 when 's' =>
|
|
1063 Debug_Flag_S := Val;
|
|
1064 when 't' =>
|
|
1065 Debug_Flag_T := Val;
|
|
1066 when 'u' =>
|
|
1067 Debug_Flag_U := Val;
|
|
1068 when 'v' =>
|
|
1069 Debug_Flag_V := Val;
|
|
1070 when 'w' =>
|
|
1071 Debug_Flag_W := Val;
|
|
1072 when 'x' =>
|
|
1073 Debug_Flag_X := Val;
|
|
1074 when 'y' =>
|
|
1075 Debug_Flag_Y := Val;
|
|
1076 when 'z' =>
|
|
1077 Debug_Flag_Z := Val;
|
|
1078 end case;
|
|
1079 end if;
|
|
1080 end Set_Debug_Flag;
|
|
1081
|
|
1082 ---------------------------
|
|
1083 -- Set_Dotted_Debug_Flag --
|
|
1084 ---------------------------
|
|
1085
|
|
1086 procedure Set_Dotted_Debug_Flag (C : Character; Val : Boolean := True) is
|
|
1087 subtype Dig is Character range '1' .. '9';
|
|
1088 subtype LLet is Character range 'a' .. 'z';
|
|
1089 subtype ULet is Character range 'A' .. 'Z';
|
|
1090
|
|
1091 begin
|
|
1092 if C in Dig then
|
|
1093 case Dig (C) is
|
|
1094 when '1' =>
|
|
1095 Debug_Flag_Dot_1 := Val;
|
|
1096 when '2' =>
|
|
1097 Debug_Flag_Dot_2 := Val;
|
|
1098 when '3' =>
|
|
1099 Debug_Flag_Dot_3 := Val;
|
|
1100 when '4' =>
|
|
1101 Debug_Flag_Dot_4 := Val;
|
|
1102 when '5' =>
|
|
1103 Debug_Flag_Dot_5 := Val;
|
|
1104 when '6' =>
|
|
1105 Debug_Flag_Dot_6 := Val;
|
|
1106 when '7' =>
|
|
1107 Debug_Flag_Dot_7 := Val;
|
|
1108 when '8' =>
|
|
1109 Debug_Flag_Dot_8 := Val;
|
|
1110 when '9' =>
|
|
1111 Debug_Flag_Dot_9 := Val;
|
|
1112 end case;
|
|
1113
|
|
1114 elsif C in ULet then
|
|
1115 case ULet (C) is
|
|
1116 when 'A' =>
|
|
1117 Debug_Flag_Dot_AA := Val;
|
|
1118 when 'B' =>
|
|
1119 Debug_Flag_Dot_BB := Val;
|
|
1120 when 'C' =>
|
|
1121 Debug_Flag_Dot_CC := Val;
|
|
1122 when 'D' =>
|
|
1123 Debug_Flag_Dot_DD := Val;
|
|
1124 when 'E' =>
|
|
1125 Debug_Flag_Dot_EE := Val;
|
|
1126 when 'F' =>
|
|
1127 Debug_Flag_Dot_FF := Val;
|
|
1128 when 'G' =>
|
|
1129 Debug_Flag_Dot_GG := Val;
|
|
1130 when 'H' =>
|
|
1131 Debug_Flag_Dot_HH := Val;
|
|
1132 when 'I' =>
|
|
1133 Debug_Flag_Dot_II := Val;
|
|
1134 when 'J' =>
|
|
1135 Debug_Flag_Dot_JJ := Val;
|
|
1136 when 'K' =>
|
|
1137 Debug_Flag_Dot_KK := Val;
|
|
1138 when 'L' =>
|
|
1139 Debug_Flag_Dot_LL := Val;
|
|
1140 when 'M' =>
|
|
1141 Debug_Flag_Dot_MM := Val;
|
|
1142 when 'N' =>
|
|
1143 Debug_Flag_Dot_NN := Val;
|
|
1144 when 'O' =>
|
|
1145 Debug_Flag_Dot_OO := Val;
|
|
1146 when 'P' =>
|
|
1147 Debug_Flag_Dot_PP := Val;
|
|
1148 when 'Q' =>
|
|
1149 Debug_Flag_Dot_QQ := Val;
|
|
1150 when 'R' =>
|
|
1151 Debug_Flag_Dot_RR := Val;
|
|
1152 when 'S' =>
|
|
1153 Debug_Flag_Dot_SS := Val;
|
|
1154 when 'T' =>
|
|
1155 Debug_Flag_Dot_TT := Val;
|
|
1156 when 'U' =>
|
|
1157 Debug_Flag_Dot_UU := Val;
|
|
1158 when 'V' =>
|
|
1159 Debug_Flag_Dot_VV := Val;
|
|
1160 when 'W' =>
|
|
1161 Debug_Flag_Dot_WW := Val;
|
|
1162 when 'X' =>
|
|
1163 Debug_Flag_Dot_XX := Val;
|
|
1164 when 'Y' =>
|
|
1165 Debug_Flag_Dot_YY := Val;
|
|
1166 when 'Z' =>
|
|
1167 Debug_Flag_Dot_ZZ := Val;
|
|
1168 end case;
|
|
1169
|
|
1170 else
|
|
1171 case LLet (C) is
|
|
1172 when 'a' =>
|
|
1173 Debug_Flag_Dot_A := Val;
|
|
1174 when 'b' =>
|
|
1175 Debug_Flag_Dot_B := Val;
|
|
1176 when 'c' =>
|
|
1177 Debug_Flag_Dot_C := Val;
|
|
1178 when 'd' =>
|
|
1179 Debug_Flag_Dot_D := Val;
|
|
1180 when 'e' =>
|
|
1181 Debug_Flag_Dot_E := Val;
|
|
1182 when 'f' =>
|
|
1183 Debug_Flag_Dot_F := Val;
|
|
1184 when 'g' =>
|
|
1185 Debug_Flag_Dot_G := Val;
|
|
1186 when 'h' =>
|
|
1187 Debug_Flag_Dot_H := Val;
|
|
1188 when 'i' =>
|
|
1189 Debug_Flag_Dot_I := Val;
|
|
1190 when 'j' =>
|
|
1191 Debug_Flag_Dot_J := Val;
|
|
1192 when 'k' =>
|
|
1193 Debug_Flag_Dot_K := Val;
|
|
1194 when 'l' =>
|
|
1195 Debug_Flag_Dot_L := Val;
|
|
1196 when 'm' =>
|
|
1197 Debug_Flag_Dot_M := Val;
|
|
1198 when 'n' =>
|
|
1199 Debug_Flag_Dot_N := Val;
|
|
1200 when 'o' =>
|
|
1201 Debug_Flag_Dot_O := Val;
|
|
1202 when 'p' =>
|
|
1203 Debug_Flag_Dot_P := Val;
|
|
1204 when 'q' =>
|
|
1205 Debug_Flag_Dot_Q := Val;
|
|
1206 when 'r' =>
|
|
1207 Debug_Flag_Dot_R := Val;
|
|
1208 when 's' =>
|
|
1209 Debug_Flag_Dot_S := Val;
|
|
1210 when 't' =>
|
|
1211 Debug_Flag_Dot_T := Val;
|
|
1212 when 'u' =>
|
|
1213 Debug_Flag_Dot_U := Val;
|
|
1214 when 'v' =>
|
|
1215 Debug_Flag_Dot_V := Val;
|
|
1216 when 'w' =>
|
|
1217 Debug_Flag_Dot_W := Val;
|
|
1218 when 'x' =>
|
|
1219 Debug_Flag_Dot_X := Val;
|
|
1220 when 'y' =>
|
|
1221 Debug_Flag_Dot_Y := Val;
|
|
1222 when 'z' =>
|
|
1223 Debug_Flag_Dot_Z := Val;
|
|
1224 end case;
|
|
1225 end if;
|
|
1226 end Set_Dotted_Debug_Flag;
|
|
1227
|
|
1228 end Debug;
|