From: Viljar Indus <[email protected]>
Add a separate switch -gnatis to suppress info messages
separately from warning messages that are controlled by
-gnatws.
gcc/ada/
* doc/gnat_ugn/building_executable_programs_with_gnat.rst: Add
entry for -gnatis.
* errout.adb (Error_Msg_Internal): Stop printing info messages if
-gnatis was used.
* opt.ads: Add Info_Suppressed flag to track whether info messages
should be suppressed.
* switch-c.adb: Add parsing for -gnatis.
* gnat_ugn.texi: Regenerate.
Tested on x86_64-pc-linux-gnu, committed on master.
---
...building_executable_programs_with_gnat.rst | 15 +
gcc/ada/errout.adb | 7 +
gcc/ada/gnat_ugn.texi | 508 +++++++++---------
gcc/ada/opt.ads | 5 +
gcc/ada/switch-c.adb | 6 +-
5 files changed, 297 insertions(+), 244 deletions(-)
diff --git a/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst
b/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst
index 2f63d02daf7..8fbb1eeef4f 100644
--- a/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst
+++ b/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst
@@ -4372,6 +4372,21 @@ When no switch :switch:`-gnatw` is used, this is
equivalent to:
.. _Debugging_and_Assertion_Control:
+Info message Control
+--------------------
+
+In addition to the warning messages, the compiler can also generate info
+messages. In order to control the generation of these messages, the following
+switch is provided:
+
+:switch:`-gnatis`
+ *Suppress all info messages.*
+
+ This switch completely suppresses the output of all info messages from the
+ GNAT front end.
+
+
+
Debugging and Assertion Control
-------------------------------
diff --git a/gcc/ada/errout.adb b/gcc/ada/errout.adb
index 1e6b0fe4369..c4eab2deee3 100644
--- a/gcc/ada/errout.adb
+++ b/gcc/ada/errout.adb
@@ -1048,6 +1048,13 @@ package body Errout is
if Is_Info_Msg then
+ -- Immediate return if info messages are suppressed
+
+ if Info_Suppressed then
+ Cur_Msg := No_Error_Msg;
+ return;
+ end if;
+
-- If the flag location is in the main extended source unit then for
-- sure we want the message since it definitely belongs.
diff --git a/gcc/ada/gnat_ugn.texi b/gcc/ada/gnat_ugn.texi
index fb3b7e11641..fe83913951d 100644
--- a/gcc/ada/gnat_ugn.texi
+++ b/gcc/ada/gnat_ugn.texi
@@ -261,6 +261,7 @@ Compiler Switches
* Alphabetical List of All Switches::
* Output and Error Message Control::
* Warning Message Control::
+* Info message Control::
* Debugging and Assertion Control::
* Validity Checking::
* Style Checking::
@@ -8533,6 +8534,7 @@ compilation units.
* Alphabetical List of All Switches::
* Output and Error Message Control::
* Warning Message Control::
+* Info message Control::
* Debugging and Assertion Control::
* Validity Checking::
* Style Checking::
@@ -10580,7 +10582,7 @@ Note that @code{-gnatQ} has no effect if @code{-gnats}
is specified,
since ALI files are never generated if @code{-gnats} is set.
@end table
-@node Warning Message Control,Debugging and Assertion Control,Output and Error
Message Control,Compiler Switches
+@node Warning Message Control,Info message Control,Output and Error Message
Control,Compiler Switches
@anchor{gnat_ugn/building_executable_programs_with_gnat
id15}@anchor{f2}@anchor{gnat_ugn/building_executable_programs_with_gnat
warning-message-control}@anchor{ed}
@subsection Warning Message Control
@@ -12985,8 +12987,28 @@ When no switch @code{-gnatw} is used, this is
equivalent to:
@end itemize
@end quotation
-@node Debugging and Assertion Control,Validity Checking,Warning Message
Control,Compiler Switches
-@anchor{gnat_ugn/building_executable_programs_with_gnat
debugging-and-assertion-control}@anchor{f3}@anchor{gnat_ugn/building_executable_programs_with_gnat
id16}@anchor{f4}
+@node Info message Control,Debugging and Assertion Control,Warning Message
Control,Compiler Switches
+@anchor{gnat_ugn/building_executable_programs_with_gnat
debugging-and-assertion-control}@anchor{f3}@anchor{gnat_ugn/building_executable_programs_with_gnat
info-message-control}@anchor{f4}
+@subsection Info message Control
+
+
+In addition to the warning messages, the compiler can also generate info
+messages. In order to control the generation of these messages, the following
+switch is provided:
+
+
+@table @asis
+
+@item @code{-gnatis}
+
+`Suppress all info messages.'
+
+This switch completely suppresses the output of all info messages from the
+GNAT front end.
+@end table
+
+@node Debugging and Assertion Control,Validity Checking,Info message
Control,Compiler Switches
+@anchor{gnat_ugn/building_executable_programs_with_gnat id16}@anchor{f5}
@subsection Debugging and Assertion Control
@@ -13091,7 +13113,7 @@ is @code{False}, the exception @code{Assert_Failure} is
raised.
@end table
@node Validity Checking,Style Checking,Debugging and Assertion
Control,Compiler Switches
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id17}@anchor{f5}@anchor{gnat_ugn/building_executable_programs_with_gnat
validity-checking}@anchor{e9}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id17}@anchor{f6}@anchor{gnat_ugn/building_executable_programs_with_gnat
validity-checking}@anchor{e9}
@subsection Validity Checking
@@ -13389,7 +13411,7 @@ the validity checking mode at the program source level,
and also allows for
temporary disabling of validity checks.
@node Style Checking,Run-Time Checks,Validity Checking,Compiler Switches
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id18}@anchor{f6}@anchor{gnat_ugn/building_executable_programs_with_gnat
style-checking}@anchor{ee}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id18}@anchor{f7}@anchor{gnat_ugn/building_executable_programs_with_gnat
style-checking}@anchor{ee}
@subsection Style Checking
@@ -14142,7 +14164,7 @@ built-in standard style check options are enabled.
The switch @code{-gnatyN} clears any previously set style checks.
@node Run-Time Checks,Using gcc for Syntax Checking,Style Checking,Compiler
Switches
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id19}@anchor{f7}@anchor{gnat_ugn/building_executable_programs_with_gnat
run-time-checks}@anchor{ec}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id19}@anchor{f8}@anchor{gnat_ugn/building_executable_programs_with_gnat
run-time-checks}@anchor{ec}
@subsection Run-Time Checks
@@ -14363,7 +14385,7 @@ checks) or @code{Unsuppress} (to add back suppressed
checks) pragmas in
the program source.
@node Using gcc for Syntax Checking,Using gcc for Semantic Checking,Run-Time
Checks,Compiler Switches
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id20}@anchor{f8}@anchor{gnat_ugn/building_executable_programs_with_gnat
using-gcc-for-syntax-checking}@anchor{f9}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id20}@anchor{f9}@anchor{gnat_ugn/building_executable_programs_with_gnat
using-gcc-for-syntax-checking}@anchor{fa}
@subsection Using @code{gcc} for Syntax Checking
@@ -14420,7 +14442,7 @@ together. This is primarily used by the @code{gnatchop}
utility
@end table
@node Using gcc for Semantic Checking,Compiling Different Versions of
Ada,Using gcc for Syntax Checking,Compiler Switches
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id21}@anchor{fa}@anchor{gnat_ugn/building_executable_programs_with_gnat
using-gcc-for-semantic-checking}@anchor{fb}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id21}@anchor{fb}@anchor{gnat_ugn/building_executable_programs_with_gnat
using-gcc-for-semantic-checking}@anchor{fc}
@subsection Using @code{gcc} for Semantic Checking
@@ -14467,7 +14489,7 @@ and specifications where a separate body is present).
@end table
@node Compiling Different Versions of Ada,Character Set Control,Using gcc for
Semantic Checking,Compiler Switches
-@anchor{gnat_ugn/building_executable_programs_with_gnat
compiling-different-versions-of-ada}@anchor{6}@anchor{gnat_ugn/building_executable_programs_with_gnat
id22}@anchor{fc}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
compiling-different-versions-of-ada}@anchor{6}@anchor{gnat_ugn/building_executable_programs_with_gnat
id22}@anchor{fd}
@subsection Compiling Different Versions of Ada
@@ -14632,7 +14654,7 @@ extensions enabled by this switch, see the GNAT
reference manual
@end table
@node Character Set Control,File Naming Control,Compiling Different Versions
of Ada,Compiler Switches
-@anchor{gnat_ugn/building_executable_programs_with_gnat
character-set-control}@anchor{31}@anchor{gnat_ugn/building_executable_programs_with_gnat
id23}@anchor{fd}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
character-set-control}@anchor{31}@anchor{gnat_ugn/building_executable_programs_with_gnat
id23}@anchor{fe}
@subsection Character Set Control
@@ -14859,7 +14881,7 @@ comments are ended by an appropriate (CR, or CR/LF, or
LF) line terminator.
This is a common mode for many programs with foreign language comments.
@node File Naming Control,Subprogram Inlining Control,Character Set
Control,Compiler Switches
-@anchor{gnat_ugn/building_executable_programs_with_gnat
file-naming-control}@anchor{fe}@anchor{gnat_ugn/building_executable_programs_with_gnat
id24}@anchor{ff}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
file-naming-control}@anchor{ff}@anchor{gnat_ugn/building_executable_programs_with_gnat
id24}@anchor{100}
@subsection File Naming Control
@@ -14879,7 +14901,7 @@ For the source file naming rules, @ref{3b,,File Naming
Rules}.
@end table
@node Subprogram Inlining Control,Auxiliary Output Control,File Naming
Control,Compiler Switches
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id25}@anchor{100}@anchor{gnat_ugn/building_executable_programs_with_gnat
subprogram-inlining-control}@anchor{101}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id25}@anchor{101}@anchor{gnat_ugn/building_executable_programs_with_gnat
subprogram-inlining-control}@anchor{102}
@subsection Subprogram Inlining Control
@@ -14912,7 +14934,7 @@ If you specify this switch the compiler will access
these bodies,
creating an extra source dependency for the resulting object file, and
where possible, the call will be inlined.
For further details on when inlining is possible
-see @ref{102,,Inlining of Subprograms}.
+see @ref{103,,Inlining of Subprograms}.
@end table
@geindex -gnatN (gcc)
@@ -14932,7 +14954,7 @@ inlining, but that is no longer the case.
@end table
@node Auxiliary Output Control,Debugging Control,Subprogram Inlining
Control,Compiler Switches
-@anchor{gnat_ugn/building_executable_programs_with_gnat
auxiliary-output-control}@anchor{103}@anchor{gnat_ugn/building_executable_programs_with_gnat
id26}@anchor{104}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
auxiliary-output-control}@anchor{104}@anchor{gnat_ugn/building_executable_programs_with_gnat
id26}@anchor{105}
@subsection Auxiliary Output Control
@@ -15002,7 +15024,7 @@ An object file has been generated for every source file.
@end table
@node Debugging Control,Exception Handling Control,Auxiliary Output
Control,Compiler Switches
-@anchor{gnat_ugn/building_executable_programs_with_gnat
debugging-control}@anchor{105}@anchor{gnat_ugn/building_executable_programs_with_gnat
id27}@anchor{106}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
debugging-control}@anchor{106}@anchor{gnat_ugn/building_executable_programs_with_gnat
id27}@anchor{107}
@subsection Debugging Control
@@ -15351,7 +15373,7 @@ encodings for the rest.
@end table
@node Exception Handling Control,Units to Sources Mapping Files,Debugging
Control,Compiler Switches
-@anchor{gnat_ugn/building_executable_programs_with_gnat
exception-handling-control}@anchor{107}@anchor{gnat_ugn/building_executable_programs_with_gnat
id28}@anchor{108}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
exception-handling-control}@anchor{108}@anchor{gnat_ugn/building_executable_programs_with_gnat
id28}@anchor{109}
@subsection Exception Handling Control
@@ -15423,7 +15445,7 @@ and @code{gnatbind}. Passing this option to
@code{gnatmake}
through the compilation and binding steps.
@node Units to Sources Mapping Files,Code Generation Control,Exception
Handling Control,Compiler Switches
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id29}@anchor{109}@anchor{gnat_ugn/building_executable_programs_with_gnat
units-to-sources-mapping-files}@anchor{ea}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id29}@anchor{10a}@anchor{gnat_ugn/building_executable_programs_with_gnat
units-to-sources-mapping-files}@anchor{ea}
@subsection Units to Sources Mapping Files
@@ -15475,7 +15497,7 @@ mapping file and communicates it to the compiler using
this switch.
@end table
@node Code Generation Control,,Units to Sources Mapping Files,Compiler Switches
-@anchor{gnat_ugn/building_executable_programs_with_gnat
code-generation-control}@anchor{10a}@anchor{gnat_ugn/building_executable_programs_with_gnat
id30}@anchor{10b}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
code-generation-control}@anchor{10b}@anchor{gnat_ugn/building_executable_programs_with_gnat
id30}@anchor{10c}
@subsection Code Generation Control
@@ -15504,7 +15526,7 @@ there is no point in using @code{-m} switches to
improve performance
unless you actually see a performance improvement.
@node Linker Switches,Binding with gnatbind,Compiler Switches,Building
Executable Programs with GNAT
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id31}@anchor{10c}@anchor{gnat_ugn/building_executable_programs_with_gnat
linker-switches}@anchor{10d}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id31}@anchor{10d}@anchor{gnat_ugn/building_executable_programs_with_gnat
linker-switches}@anchor{10e}
@section Linker Switches
@@ -15524,7 +15546,7 @@ platforms.
@end table
@node Binding with gnatbind,Linking with gnatlink,Linker Switches,Building
Executable Programs with GNAT
-@anchor{gnat_ugn/building_executable_programs_with_gnat
binding-with-gnatbind}@anchor{ca}@anchor{gnat_ugn/building_executable_programs_with_gnat
id32}@anchor{10e}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
binding-with-gnatbind}@anchor{ca}@anchor{gnat_ugn/building_executable_programs_with_gnat
id32}@anchor{10f}
@section Binding with @code{gnatbind}
@@ -15575,7 +15597,7 @@ to be read by the @code{gnatlink} utility used to link
the Ada application.
@end menu
@node Running gnatbind,Switches for gnatbind,,Binding with gnatbind
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id33}@anchor{10f}@anchor{gnat_ugn/building_executable_programs_with_gnat
running-gnatbind}@anchor{110}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id33}@anchor{110}@anchor{gnat_ugn/building_executable_programs_with_gnat
running-gnatbind}@anchor{111}
@subsection Running @code{gnatbind}
@@ -15660,7 +15682,7 @@ Ada code provided the @code{-g} switch is used for
@code{gnatbind} and @code{gnatlink}.
@node Switches for gnatbind,Command-Line Access,Running gnatbind,Binding with
gnatbind
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id34}@anchor{111}@anchor{gnat_ugn/building_executable_programs_with_gnat
switches-for-gnatbind}@anchor{112}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id34}@anchor{112}@anchor{gnat_ugn/building_executable_programs_with_gnat
switches-for-gnatbind}@anchor{113}
@subsection Switches for @code{gnatbind}
@@ -15855,7 +15877,7 @@ Currently the same as @code{-Ea}.
@item @code{-f`elab-order'}
-Force elaboration order. For further details see @ref{113,,Elaboration Control}
+Force elaboration order. For further details see @ref{114,,Elaboration Control}
and @ref{f,,Elaboration Order Handling in GNAT}.
@end table
@@ -15904,7 +15926,7 @@ Legacy elaboration order model enabled. For further
details see
@item @code{-H32}
Use 32-bit allocations for @code{__gnat_malloc} (and thus for access types).
-For further details see @ref{114,,Dynamic Allocation Control}.
+For further details see @ref{115,,Dynamic Allocation Control}.
@end table
@geindex -H64 (gnatbind)
@@ -15917,7 +15939,7 @@ For further details see @ref{114,,Dynamic Allocation
Control}.
@item @code{-H64}
Use 64-bit allocations for @code{__gnat_malloc} (and thus for access types).
-For further details see @ref{114,,Dynamic Allocation Control}.
+For further details see @ref{115,,Dynamic Allocation Control}.
@geindex -I (gnatbind)
@@ -16206,7 +16228,7 @@ Enable dynamic stack usage, with @code{n} results
stored and displayed
at program termination. A result is generated when a task
terminates. Results that can’t be stored are displayed on the fly, at
task termination. This option is currently not supported on Itanium
-platforms. (See @ref{115,,Dynamic Stack Usage Analysis} for details.)
+platforms. (See @ref{116,,Dynamic Stack Usage Analysis} for details.)
@geindex -v (gnatbind)
@@ -16286,7 +16308,7 @@ no arguments.
@end menu
@node Consistency-Checking Modes,Binder Error Message Control,,Switches for
gnatbind
-@anchor{gnat_ugn/building_executable_programs_with_gnat
consistency-checking-modes}@anchor{116}@anchor{gnat_ugn/building_executable_programs_with_gnat
id35}@anchor{117}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
consistency-checking-modes}@anchor{117}@anchor{gnat_ugn/building_executable_programs_with_gnat
id35}@anchor{118}
@subsubsection Consistency-Checking Modes
@@ -16340,7 +16362,7 @@ case the checking against sources has already been
performed by
@end table
@node Binder Error Message Control,Elaboration Control,Consistency-Checking
Modes,Switches for gnatbind
-@anchor{gnat_ugn/building_executable_programs_with_gnat
binder-error-message-control}@anchor{118}@anchor{gnat_ugn/building_executable_programs_with_gnat
id36}@anchor{119}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
binder-error-message-control}@anchor{119}@anchor{gnat_ugn/building_executable_programs_with_gnat
id36}@anchor{11a}
@subsubsection Binder Error Message Control
@@ -16450,7 +16472,7 @@ with extreme care.
@end table
@node Elaboration Control,Output Control,Binder Error Message Control,Switches
for gnatbind
-@anchor{gnat_ugn/building_executable_programs_with_gnat
elaboration-control}@anchor{113}@anchor{gnat_ugn/building_executable_programs_with_gnat
id37}@anchor{11a}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
elaboration-control}@anchor{114}@anchor{gnat_ugn/building_executable_programs_with_gnat
id37}@anchor{11b}
@subsubsection Elaboration Control
@@ -16535,7 +16557,7 @@ debugging/experimental use.
@end table
@node Output Control,Dynamic Allocation Control,Elaboration Control,Switches
for gnatbind
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id38}@anchor{11b}@anchor{gnat_ugn/building_executable_programs_with_gnat
output-control}@anchor{11c}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id38}@anchor{11c}@anchor{gnat_ugn/building_executable_programs_with_gnat
output-control}@anchor{11d}
@subsubsection Output Control
@@ -16616,7 +16638,7 @@ be used to improve code generation in some cases.
@end table
@node Dynamic Allocation Control,Binding with Non-Ada Main Programs,Output
Control,Switches for gnatbind
-@anchor{gnat_ugn/building_executable_programs_with_gnat
dynamic-allocation-control}@anchor{114}@anchor{gnat_ugn/building_executable_programs_with_gnat
id39}@anchor{11d}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
dynamic-allocation-control}@anchor{115}@anchor{gnat_ugn/building_executable_programs_with_gnat
id39}@anchor{11e}
@subsubsection Dynamic Allocation Control
@@ -16642,7 +16664,7 @@ unless explicitly overridden by a @code{'Size} clause
on the access type.
These switches are only effective on VMS platforms.
@node Binding with Non-Ada Main Programs,Binding Programs with No Main
Subprogram,Dynamic Allocation Control,Switches for gnatbind
-@anchor{gnat_ugn/building_executable_programs_with_gnat
binding-with-non-ada-main-programs}@anchor{7e}@anchor{gnat_ugn/building_executable_programs_with_gnat
id40}@anchor{11e}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
binding-with-non-ada-main-programs}@anchor{7e}@anchor{gnat_ugn/building_executable_programs_with_gnat
id40}@anchor{11f}
@subsubsection Binding with Non-Ada Main Programs
@@ -16738,7 +16760,7 @@ side effect is that this could be the wrong mode for
the foreign code
where floating point computation could be broken after this call.
@node Binding Programs with No Main Subprogram,,Binding with Non-Ada Main
Programs,Switches for gnatbind
-@anchor{gnat_ugn/building_executable_programs_with_gnat
binding-programs-with-no-main-subprogram}@anchor{11f}@anchor{gnat_ugn/building_executable_programs_with_gnat
id41}@anchor{120}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
binding-programs-with-no-main-subprogram}@anchor{120}@anchor{gnat_ugn/building_executable_programs_with_gnat
id41}@anchor{121}
@subsubsection Binding Programs with No Main Subprogram
@@ -16769,7 +16791,7 @@ the binder switch
@end table
@node Command-Line Access,Search Paths for gnatbind,Switches for
gnatbind,Binding with gnatbind
-@anchor{gnat_ugn/building_executable_programs_with_gnat
command-line-access}@anchor{121}@anchor{gnat_ugn/building_executable_programs_with_gnat
id42}@anchor{122}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
command-line-access}@anchor{122}@anchor{gnat_ugn/building_executable_programs_with_gnat
id42}@anchor{123}
@subsection Command-Line Access
@@ -16799,7 +16821,7 @@ required, your main program must set @code{gnat_argc}
and
it.
@node Search Paths for gnatbind,Examples of gnatbind Usage,Command-Line
Access,Binding with gnatbind
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id43}@anchor{123}@anchor{gnat_ugn/building_executable_programs_with_gnat
search-paths-for-gnatbind}@anchor{76}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id43}@anchor{124}@anchor{gnat_ugn/building_executable_programs_with_gnat
search-paths-for-gnatbind}@anchor{76}
@subsection Search Paths for @code{gnatbind}
@@ -16903,7 +16925,7 @@ in compiling sources from multiple directories. This
can make
development environments much more flexible.
@node Examples of gnatbind Usage,,Search Paths for gnatbind,Binding with
gnatbind
-@anchor{gnat_ugn/building_executable_programs_with_gnat
examples-of-gnatbind-usage}@anchor{124}@anchor{gnat_ugn/building_executable_programs_with_gnat
id44}@anchor{125}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
examples-of-gnatbind-usage}@anchor{125}@anchor{gnat_ugn/building_executable_programs_with_gnat
id44}@anchor{126}
@subsection Examples of @code{gnatbind} Usage
@@ -16932,7 +16954,7 @@ since gnatlink will not be able to find the generated
file.
@end quotation
@node Linking with gnatlink,Using the GNU make Utility,Binding with
gnatbind,Building Executable Programs with GNAT
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id45}@anchor{126}@anchor{gnat_ugn/building_executable_programs_with_gnat
linking-with-gnatlink}@anchor{cb}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id45}@anchor{127}@anchor{gnat_ugn/building_executable_programs_with_gnat
linking-with-gnatlink}@anchor{cb}
@section Linking with @code{gnatlink}
@@ -16953,7 +16975,7 @@ generated by the @code{gnatbind} to determine this list.
@end menu
@node Running gnatlink,Switches for gnatlink,,Linking with gnatlink
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id46}@anchor{127}@anchor{gnat_ugn/building_executable_programs_with_gnat
running-gnatlink}@anchor{128}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id46}@anchor{128}@anchor{gnat_ugn/building_executable_programs_with_gnat
running-gnatlink}@anchor{129}
@subsection Running @code{gnatlink}
@@ -17012,8 +17034,8 @@ $ gnatlink my_prog -Wl,-Map,MAPFILE
Using @code{linker options} it is possible to set the program stack and
heap size.
-See @ref{129,,Setting Stack Size from gnatlink} and
-@ref{12a,,Setting Heap Size from gnatlink}.
+See @ref{12a,,Setting Stack Size from gnatlink} and
+@ref{12b,,Setting Heap Size from gnatlink}.
@code{gnatlink} determines the list of objects required by the Ada
program and prepends them to the list of objects passed to the linker.
@@ -17022,7 +17044,7 @@ program and prepends them to the list of objects passed
to the linker.
presented to the linker.
@node Switches for gnatlink,,Running gnatlink,Linking with gnatlink
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id47}@anchor{12b}@anchor{gnat_ugn/building_executable_programs_with_gnat
switches-for-gnatlink}@anchor{12c}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id47}@anchor{12c}@anchor{gnat_ugn/building_executable_programs_with_gnat
switches-for-gnatlink}@anchor{12d}
@subsection Switches for @code{gnatlink}
@@ -17217,7 +17239,7 @@ switch.
@end table
@node Using the GNU make Utility,,Linking with gnatlink,Building Executable
Programs with GNAT
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id48}@anchor{12d}@anchor{gnat_ugn/building_executable_programs_with_gnat
using-the-gnu-make-utility}@anchor{70}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id48}@anchor{12e}@anchor{gnat_ugn/building_executable_programs_with_gnat
using-the-gnu-make-utility}@anchor{70}
@section Using the GNU @code{make} Utility
@@ -17242,7 +17264,7 @@ is the same, these examples use some advanced features
found only in
@end menu
@node Using gnatmake in a Makefile,Automatically Creating a List of
Directories,,Using the GNU make Utility
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id49}@anchor{12e}@anchor{gnat_ugn/building_executable_programs_with_gnat
using-gnatmake-in-a-makefile}@anchor{12f}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id49}@anchor{12f}@anchor{gnat_ugn/building_executable_programs_with_gnat
using-gnatmake-in-a-makefile}@anchor{130}
@subsection Using gnatmake in a Makefile
@@ -17261,7 +17283,7 @@ the appropriate directories.
Note that you should also read the example on how to automatically
create the list of directories
-(@ref{130,,Automatically Creating a List of Directories})
+(@ref{131,,Automatically Creating a List of Directories})
which might help you in case your project has a lot of subdirectories.
@example
@@ -17341,7 +17363,7 @@ clean::
@end example
@node Automatically Creating a List of Directories,Generating the Command Line
Switches,Using gnatmake in a Makefile,Using the GNU make Utility
-@anchor{gnat_ugn/building_executable_programs_with_gnat
automatically-creating-a-list-of-directories}@anchor{130}@anchor{gnat_ugn/building_executable_programs_with_gnat
id50}@anchor{131}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
automatically-creating-a-list-of-directories}@anchor{131}@anchor{gnat_ugn/building_executable_programs_with_gnat
id50}@anchor{132}
@subsection Automatically Creating a List of Directories
@@ -17414,12 +17436,12 @@ DIRS := $@{shell find $@{ROOT_DIRECTORY@} -type d
-print@}
@end example
@node Generating the Command Line Switches,Overcoming Command Line Length
Limits,Automatically Creating a List of Directories,Using the GNU make Utility
-@anchor{gnat_ugn/building_executable_programs_with_gnat
generating-the-command-line-switches}@anchor{132}@anchor{gnat_ugn/building_executable_programs_with_gnat
id51}@anchor{133}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
generating-the-command-line-switches}@anchor{133}@anchor{gnat_ugn/building_executable_programs_with_gnat
id51}@anchor{134}
@subsection Generating the Command Line Switches
Once you have created the list of directories as explained in the
-previous section (@ref{130,,Automatically Creating a List of Directories}),
+previous section (@ref{131,,Automatically Creating a List of Directories}),
you can easily generate the command line arguments to pass to gnatmake.
For the sake of completeness, this example assumes that the source path
@@ -17440,7 +17462,7 @@ all:
@end example
@node Overcoming Command Line Length Limits,,Generating the Command Line
Switches,Using the GNU make Utility
-@anchor{gnat_ugn/building_executable_programs_with_gnat
id52}@anchor{134}@anchor{gnat_ugn/building_executable_programs_with_gnat
overcoming-command-line-length-limits}@anchor{135}
+@anchor{gnat_ugn/building_executable_programs_with_gnat
id52}@anchor{135}@anchor{gnat_ugn/building_executable_programs_with_gnat
overcoming-command-line-length-limits}@anchor{136}
@subsection Overcoming Command Line Length Limits
@@ -17455,7 +17477,7 @@ even none on most systems).
It assumes that you have created a list of directories in your Makefile,
using one of the methods presented in
-@ref{130,,Automatically Creating a List of Directories}.
+@ref{131,,Automatically Creating a List of Directories}.
For the sake of completeness, we assume that the object
path (where the ALI files are found) is different from the sources patch.
@@ -17498,7 +17520,7 @@ all:
@end example
@node GNAT Utility Programs,GNAT and Program Execution,Building Executable
Programs with GNAT,Top
-@anchor{gnat_ugn/gnat_utility_programs
doc}@anchor{136}@anchor{gnat_ugn/gnat_utility_programs
gnat-utility-programs}@anchor{b}@anchor{gnat_ugn/gnat_utility_programs
id1}@anchor{137}
+@anchor{gnat_ugn/gnat_utility_programs
doc}@anchor{137}@anchor{gnat_ugn/gnat_utility_programs
gnat-utility-programs}@anchor{b}@anchor{gnat_ugn/gnat_utility_programs
id1}@anchor{138}
@chapter GNAT Utility Programs
@@ -17509,10 +17531,10 @@ This chapter describes a number of utility programs:
@itemize *
@item
-@ref{138,,The File Cleanup Utility gnatclean}
+@ref{139,,The File Cleanup Utility gnatclean}
@item
-@ref{139,,The GNAT Library Browser gnatls}
+@ref{13a,,The GNAT Library Browser gnatls}
@end itemize
Other GNAT utilities are described elsewhere in this manual:
@@ -17540,7 +17562,7 @@ Other GNAT utilities are described elsewhere in this
manual:
@end menu
@node The File Cleanup Utility gnatclean,The GNAT Library Browser gnatls,,GNAT
Utility Programs
-@anchor{gnat_ugn/gnat_utility_programs
id2}@anchor{13a}@anchor{gnat_ugn/gnat_utility_programs
the-file-cleanup-utility-gnatclean}@anchor{138}
+@anchor{gnat_ugn/gnat_utility_programs
id2}@anchor{13b}@anchor{gnat_ugn/gnat_utility_programs
the-file-cleanup-utility-gnatclean}@anchor{139}
@section The File Cleanup Utility @code{gnatclean}
@@ -17560,7 +17582,7 @@ generated files and executable files.
@end menu
@node Running gnatclean,Switches for gnatclean,,The File Cleanup Utility
gnatclean
-@anchor{gnat_ugn/gnat_utility_programs
id3}@anchor{13b}@anchor{gnat_ugn/gnat_utility_programs
running-gnatclean}@anchor{13c}
+@anchor{gnat_ugn/gnat_utility_programs
id3}@anchor{13c}@anchor{gnat_ugn/gnat_utility_programs
running-gnatclean}@anchor{13d}
@subsection Running @code{gnatclean}
@@ -17584,7 +17606,7 @@ the linker. In informative-only mode, specified by
switch
normal mode is listed, but no file is actually deleted.
@node Switches for gnatclean,,Running gnatclean,The File Cleanup Utility
gnatclean
-@anchor{gnat_ugn/gnat_utility_programs
id4}@anchor{13d}@anchor{gnat_ugn/gnat_utility_programs
switches-for-gnatclean}@anchor{13e}
+@anchor{gnat_ugn/gnat_utility_programs
id4}@anchor{13e}@anchor{gnat_ugn/gnat_utility_programs
switches-for-gnatclean}@anchor{13f}
@subsection Switches for @code{gnatclean}
@@ -17786,7 +17808,7 @@ where @code{gnatclean} was invoked.
@end table
@node The GNAT Library Browser gnatls,,The File Cleanup Utility gnatclean,GNAT
Utility Programs
-@anchor{gnat_ugn/gnat_utility_programs
id5}@anchor{13f}@anchor{gnat_ugn/gnat_utility_programs
the-gnat-library-browser-gnatls}@anchor{139}
+@anchor{gnat_ugn/gnat_utility_programs
id5}@anchor{140}@anchor{gnat_ugn/gnat_utility_programs
the-gnat-library-browser-gnatls}@anchor{13a}
@section The GNAT Library Browser @code{gnatls}
@@ -17807,7 +17829,7 @@ as well as various characteristics.
@end menu
@node Running gnatls,Switches for gnatls,,The GNAT Library Browser gnatls
-@anchor{gnat_ugn/gnat_utility_programs
id6}@anchor{140}@anchor{gnat_ugn/gnat_utility_programs
running-gnatls}@anchor{141}
+@anchor{gnat_ugn/gnat_utility_programs
id6}@anchor{141}@anchor{gnat_ugn/gnat_utility_programs
running-gnatls}@anchor{142}
@subsection Running @code{gnatls}
@@ -17887,7 +17909,7 @@ version of the same source that has been modified.
@end table
@node Switches for gnatls,Example of gnatls Usage,Running gnatls,The GNAT
Library Browser gnatls
-@anchor{gnat_ugn/gnat_utility_programs
id7}@anchor{142}@anchor{gnat_ugn/gnat_utility_programs
switches-for-gnatls}@anchor{143}
+@anchor{gnat_ugn/gnat_utility_programs
id7}@anchor{143}@anchor{gnat_ugn/gnat_utility_programs
switches-for-gnatls}@anchor{144}
@subsection Switches for @code{gnatls}
@@ -18069,7 +18091,7 @@ by the user.
@end table
@node Example of gnatls Usage,,Switches for gnatls,The GNAT Library Browser
gnatls
-@anchor{gnat_ugn/gnat_utility_programs
example-of-gnatls-usage}@anchor{144}@anchor{gnat_ugn/gnat_utility_programs
id8}@anchor{145}
+@anchor{gnat_ugn/gnat_utility_programs
example-of-gnatls-usage}@anchor{145}@anchor{gnat_ugn/gnat_utility_programs
id8}@anchor{146}
@subsection Example of @code{gnatls} Usage
@@ -18155,7 +18177,7 @@ instr.ads
@c -- Example: A |withing| unit has a |with| clause, it |withs| a |withed| unit
@node GNAT and Program Execution,Platform-Specific Information,GNAT Utility
Programs,Top
-@anchor{gnat_ugn/gnat_and_program_execution
doc}@anchor{146}@anchor{gnat_ugn/gnat_and_program_execution
gnat-and-program-execution}@anchor{c}@anchor{gnat_ugn/gnat_and_program_execution
id1}@anchor{147}
+@anchor{gnat_ugn/gnat_and_program_execution
doc}@anchor{147}@anchor{gnat_ugn/gnat_and_program_execution
gnat-and-program-execution}@anchor{c}@anchor{gnat_ugn/gnat_and_program_execution
id1}@anchor{148}
@chapter GNAT and Program Execution
@@ -18165,25 +18187,25 @@ This chapter covers several topics:
@itemize *
@item
-@ref{148,,Running and Debugging Ada Programs}
+@ref{149,,Running and Debugging Ada Programs}
@item
-@ref{149,,Profiling}
+@ref{14a,,Profiling}
@item
-@ref{14a,,Improving Performance}
+@ref{14b,,Improving Performance}
@item
-@ref{14b,,Overflow Check Handling in GNAT}
+@ref{14c,,Overflow Check Handling in GNAT}
@item
-@ref{14c,,Performing Dimensionality Analysis in GNAT}
+@ref{14d,,Performing Dimensionality Analysis in GNAT}
@item
-@ref{14d,,Stack Related Facilities}
+@ref{14e,,Stack Related Facilities}
@item
-@ref{14e,,Memory Management Issues}
+@ref{14f,,Memory Management Issues}
@end itemize
@menu
@@ -18198,7 +18220,7 @@ This chapter covers several topics:
@end menu
@node Running and Debugging Ada Programs,Profiling,,GNAT and Program Execution
-@anchor{gnat_ugn/gnat_and_program_execution
id2}@anchor{148}@anchor{gnat_ugn/gnat_and_program_execution
running-and-debugging-ada-programs}@anchor{14f}
+@anchor{gnat_ugn/gnat_and_program_execution
id2}@anchor{149}@anchor{gnat_ugn/gnat_and_program_execution
running-and-debugging-ada-programs}@anchor{150}
@section Running and Debugging Ada Programs
@@ -18252,7 +18274,7 @@ the incorrect user program.
@end menu
@node The GNAT Debugger GDB,Running GDB,,Running and Debugging Ada Programs
-@anchor{gnat_ugn/gnat_and_program_execution
id3}@anchor{150}@anchor{gnat_ugn/gnat_and_program_execution
the-gnat-debugger-gdb}@anchor{151}
+@anchor{gnat_ugn/gnat_and_program_execution
id3}@anchor{151}@anchor{gnat_ugn/gnat_and_program_execution
the-gnat-debugger-gdb}@anchor{152}
@subsection The GNAT Debugger GDB
@@ -18309,7 +18331,7 @@ the debugging information and can respond to user
commands to inspect
variables, and more generally to report on the state of execution.
@node Running GDB,Introduction to GDB Commands,The GNAT Debugger GDB,Running
and Debugging Ada Programs
-@anchor{gnat_ugn/gnat_and_program_execution
id4}@anchor{152}@anchor{gnat_ugn/gnat_and_program_execution
running-gdb}@anchor{153}
+@anchor{gnat_ugn/gnat_and_program_execution
id4}@anchor{153}@anchor{gnat_ugn/gnat_and_program_execution
running-gdb}@anchor{154}
@subsection Running GDB
@@ -18336,7 +18358,7 @@ exactly as if the debugger were not present. The
following section
describes some of the additional commands that can be given to @code{GDB}.
@node Introduction to GDB Commands,Using Ada Expressions,Running GDB,Running
and Debugging Ada Programs
-@anchor{gnat_ugn/gnat_and_program_execution
id5}@anchor{154}@anchor{gnat_ugn/gnat_and_program_execution
introduction-to-gdb-commands}@anchor{155}
+@anchor{gnat_ugn/gnat_and_program_execution
id5}@anchor{155}@anchor{gnat_ugn/gnat_and_program_execution
introduction-to-gdb-commands}@anchor{156}
@subsection Introduction to GDB Commands
@@ -18544,7 +18566,7 @@ Note that most commands can be abbreviated
(for example, c for continue, bt for backtrace).
@node Using Ada Expressions,Calling User-Defined Subprograms,Introduction to
GDB Commands,Running and Debugging Ada Programs
-@anchor{gnat_ugn/gnat_and_program_execution
id6}@anchor{156}@anchor{gnat_ugn/gnat_and_program_execution
using-ada-expressions}@anchor{157}
+@anchor{gnat_ugn/gnat_and_program_execution
id6}@anchor{157}@anchor{gnat_ugn/gnat_and_program_execution
using-ada-expressions}@anchor{158}
@subsection Using Ada Expressions
@@ -18582,7 +18604,7 @@ their packages, regardless of context. Where this
causes ambiguity,
For details on the supported Ada syntax, see @cite{Debugging with GDB}.
@node Calling User-Defined Subprograms,Using the next Command in a
Function,Using Ada Expressions,Running and Debugging Ada Programs
-@anchor{gnat_ugn/gnat_and_program_execution
calling-user-defined-subprograms}@anchor{158}@anchor{gnat_ugn/gnat_and_program_execution
id7}@anchor{159}
+@anchor{gnat_ugn/gnat_and_program_execution
calling-user-defined-subprograms}@anchor{159}@anchor{gnat_ugn/gnat_and_program_execution
id7}@anchor{15a}
@subsection Calling User-Defined Subprograms
@@ -18641,7 +18663,7 @@ elements directly from GDB, you can write a callable
procedure that prints
the elements in the desired format.
@node Using the next Command in a Function,Stopping When Ada Exceptions Are
Raised,Calling User-Defined Subprograms,Running and Debugging Ada Programs
-@anchor{gnat_ugn/gnat_and_program_execution
id8}@anchor{15a}@anchor{gnat_ugn/gnat_and_program_execution
using-the-next-command-in-a-function}@anchor{15b}
+@anchor{gnat_ugn/gnat_and_program_execution
id8}@anchor{15b}@anchor{gnat_ugn/gnat_and_program_execution
using-the-next-command-in-a-function}@anchor{15c}
@subsection Using the `next' Command in a Function
@@ -18664,7 +18686,7 @@ The value returned is always that from the first return
statement
that was stepped through.
@node Stopping When Ada Exceptions Are Raised,Ada Tasks,Using the next Command
in a Function,Running and Debugging Ada Programs
-@anchor{gnat_ugn/gnat_and_program_execution
id9}@anchor{15c}@anchor{gnat_ugn/gnat_and_program_execution
stopping-when-ada-exceptions-are-raised}@anchor{15d}
+@anchor{gnat_ugn/gnat_and_program_execution
id9}@anchor{15d}@anchor{gnat_ugn/gnat_and_program_execution
stopping-when-ada-exceptions-are-raised}@anchor{15e}
@subsection Stopping When Ada Exceptions Are Raised
@@ -18721,7 +18743,7 @@ argument, prints out only those exceptions whose name
matches `regexp'.
@geindex Tasks (in gdb)
@node Ada Tasks,Debugging Generic Units,Stopping When Ada Exceptions Are
Raised,Running and Debugging Ada Programs
-@anchor{gnat_ugn/gnat_and_program_execution
ada-tasks}@anchor{15e}@anchor{gnat_ugn/gnat_and_program_execution
id10}@anchor{15f}
+@anchor{gnat_ugn/gnat_and_program_execution
ada-tasks}@anchor{15f}@anchor{gnat_ugn/gnat_and_program_execution
id10}@anchor{160}
@subsection Ada Tasks
@@ -18808,7 +18830,7 @@ see @cite{Debugging with GDB}.
@geindex Generics
@node Debugging Generic Units,Remote Debugging with gdbserver,Ada
Tasks,Running and Debugging Ada Programs
-@anchor{gnat_ugn/gnat_and_program_execution
debugging-generic-units}@anchor{160}@anchor{gnat_ugn/gnat_and_program_execution
id11}@anchor{161}
+@anchor{gnat_ugn/gnat_and_program_execution
debugging-generic-units}@anchor{161}@anchor{gnat_ugn/gnat_and_program_execution
id11}@anchor{162}
@subsection Debugging Generic Units
@@ -18867,7 +18889,7 @@ other units.
@geindex Remote Debugging with gdbserver
@node Remote Debugging with gdbserver,GNAT Abnormal Termination or Failure to
Terminate,Debugging Generic Units,Running and Debugging Ada Programs
-@anchor{gnat_ugn/gnat_and_program_execution
id12}@anchor{162}@anchor{gnat_ugn/gnat_and_program_execution
remote-debugging-with-gdbserver}@anchor{163}
+@anchor{gnat_ugn/gnat_and_program_execution
id12}@anchor{163}@anchor{gnat_ugn/gnat_and_program_execution
remote-debugging-with-gdbserver}@anchor{164}
@subsection Remote Debugging with gdbserver
@@ -18925,7 +18947,7 @@ GNAT provides support for gdbserver on x86-linux,
x86-windows and x86_64-linux.
@geindex Abnormal Termination or Failure to Terminate
@node GNAT Abnormal Termination or Failure to Terminate,Naming Conventions for
GNAT Source Files,Remote Debugging with gdbserver,Running and Debugging Ada
Programs
-@anchor{gnat_ugn/gnat_and_program_execution
gnat-abnormal-termination-or-failure-to-terminate}@anchor{164}@anchor{gnat_ugn/gnat_and_program_execution
id13}@anchor{165}
+@anchor{gnat_ugn/gnat_and_program_execution
gnat-abnormal-termination-or-failure-to-terminate}@anchor{165}@anchor{gnat_ugn/gnat_and_program_execution
id13}@anchor{166}
@subsection GNAT Abnormal Termination or Failure to Terminate
@@ -18980,7 +19002,7 @@ Finally, you can start
@code{gdb} directly on the @code{gnat1} executable. @code{gnat1} is the
front-end of GNAT, and can be run independently (normally it is just
called from @code{gcc}). You can use @code{gdb} on @code{gnat1} as you
-would on a C program (but @ref{151,,The GNAT Debugger GDB} for caveats). The
+would on a C program (but @ref{152,,The GNAT Debugger GDB} for caveats). The
@code{where} command is the first line of attack; the variable
@code{lineno} (seen by @code{print lineno}), used by the second phase of
@code{gnat1} and by the @code{gcc} backend, indicates the source line at
@@ -18989,7 +19011,7 @@ the source file.
@end itemize
@node Naming Conventions for GNAT Source Files,Getting Internal Debugging
Information,GNAT Abnormal Termination or Failure to Terminate,Running and
Debugging Ada Programs
-@anchor{gnat_ugn/gnat_and_program_execution
id14}@anchor{166}@anchor{gnat_ugn/gnat_and_program_execution
naming-conventions-for-gnat-source-files}@anchor{167}
+@anchor{gnat_ugn/gnat_and_program_execution
id14}@anchor{167}@anchor{gnat_ugn/gnat_and_program_execution
naming-conventions-for-gnat-source-files}@anchor{168}
@subsection Naming Conventions for GNAT Source Files
@@ -19070,7 +19092,7 @@ the other @code{.c} files are modifications of common
@code{gcc} files.
@end itemize
@node Getting Internal Debugging Information,Stack Traceback,Naming
Conventions for GNAT Source Files,Running and Debugging Ada Programs
-@anchor{gnat_ugn/gnat_and_program_execution
getting-internal-debugging-information}@anchor{168}@anchor{gnat_ugn/gnat_and_program_execution
id15}@anchor{169}
+@anchor{gnat_ugn/gnat_and_program_execution
getting-internal-debugging-information}@anchor{169}@anchor{gnat_ugn/gnat_and_program_execution
id15}@anchor{16a}
@subsection Getting Internal Debugging Information
@@ -19098,7 +19120,7 @@ are replaced with run-time calls.
@geindex stack unwinding
@node Stack Traceback,Pretty-Printers for the GNAT runtime,Getting Internal
Debugging Information,Running and Debugging Ada Programs
-@anchor{gnat_ugn/gnat_and_program_execution
id16}@anchor{16a}@anchor{gnat_ugn/gnat_and_program_execution
stack-traceback}@anchor{16b}
+@anchor{gnat_ugn/gnat_and_program_execution
id16}@anchor{16b}@anchor{gnat_ugn/gnat_and_program_execution
stack-traceback}@anchor{16c}
@subsection Stack Traceback
@@ -19127,7 +19149,7 @@ is enabled, and no exception is raised during program
execution.
@end menu
@node Non-Symbolic Traceback,Symbolic Traceback,,Stack Traceback
-@anchor{gnat_ugn/gnat_and_program_execution
id17}@anchor{16c}@anchor{gnat_ugn/gnat_and_program_execution
non-symbolic-traceback}@anchor{16d}
+@anchor{gnat_ugn/gnat_and_program_execution
id17}@anchor{16d}@anchor{gnat_ugn/gnat_and_program_execution
non-symbolic-traceback}@anchor{16e}
@subsubsection Non-Symbolic Traceback
@@ -19260,7 +19282,7 @@ $ addr2line -e stb -a -f -p --demangle=gnat 0x401373
0x40138b
From this traceback we can see that the exception was raised in @code{stb.adb}
at line 5, which was reached from a procedure call in @code{stb.adb} at line
10, and so on. The @code{b~std.adb} is the binder file, which contains the
-call to the main program. @ref{110,,Running gnatbind}. The remaining entries
are
+call to the main program. @ref{111,,Running gnatbind}. The remaining entries
are
assorted runtime routines and the output will vary from platform to platform.
It is also possible to use @code{GDB} with these traceback addresses to debug
@@ -19448,7 +19470,7 @@ addresses need to be specified in C format, with a
leading ‘0x’).
@geindex symbolic
@node Symbolic Traceback,,Non-Symbolic Traceback,Stack Traceback
-@anchor{gnat_ugn/gnat_and_program_execution
id18}@anchor{16e}@anchor{gnat_ugn/gnat_and_program_execution
symbolic-traceback}@anchor{16f}
+@anchor{gnat_ugn/gnat_and_program_execution
id18}@anchor{16f}@anchor{gnat_ugn/gnat_and_program_execution
symbolic-traceback}@anchor{170}
@subsubsection Symbolic Traceback
@@ -19567,7 +19589,7 @@ which will also be printed if an unhandled exception
terminates the
program.
@node Pretty-Printers for the GNAT runtime,,Stack Traceback,Running and
Debugging Ada Programs
-@anchor{gnat_ugn/gnat_and_program_execution
id19}@anchor{170}@anchor{gnat_ugn/gnat_and_program_execution
pretty-printers-for-the-gnat-runtime}@anchor{171}
+@anchor{gnat_ugn/gnat_and_program_execution
id19}@anchor{171}@anchor{gnat_ugn/gnat_and_program_execution
pretty-printers-for-the-gnat-runtime}@anchor{172}
@subsection Pretty-Printers for the GNAT runtime
@@ -19674,7 +19696,7 @@ for more information.
@geindex Profiling
@node Profiling,Improving Performance,Running and Debugging Ada Programs,GNAT
and Program Execution
-@anchor{gnat_ugn/gnat_and_program_execution
id20}@anchor{172}@anchor{gnat_ugn/gnat_and_program_execution
profiling}@anchor{149}
+@anchor{gnat_ugn/gnat_and_program_execution
id20}@anchor{173}@anchor{gnat_ugn/gnat_and_program_execution
profiling}@anchor{14a}
@section Profiling
@@ -19690,7 +19712,7 @@ This section describes how to use the @code{gprof}
profiler tool on Ada programs
@end menu
@node Profiling an Ada Program with gprof,,,Profiling
-@anchor{gnat_ugn/gnat_and_program_execution
id21}@anchor{173}@anchor{gnat_ugn/gnat_and_program_execution
profiling-an-ada-program-with-gprof}@anchor{174}
+@anchor{gnat_ugn/gnat_and_program_execution
id21}@anchor{174}@anchor{gnat_ugn/gnat_and_program_execution
profiling-an-ada-program-with-gprof}@anchor{175}
@subsection Profiling an Ada Program with gprof
@@ -19744,7 +19766,7 @@ to interpret the results.
@end menu
@node Compilation for profiling,Program execution,,Profiling an Ada Program
with gprof
-@anchor{gnat_ugn/gnat_and_program_execution
compilation-for-profiling}@anchor{175}@anchor{gnat_ugn/gnat_and_program_execution
id22}@anchor{176}
+@anchor{gnat_ugn/gnat_and_program_execution
compilation-for-profiling}@anchor{176}@anchor{gnat_ugn/gnat_and_program_execution
id22}@anchor{177}
@subsubsection Compilation for profiling
@@ -19775,7 +19797,7 @@ Note that on Windows, gprof does not support PIE. The
@code{-no-pie} switch
should be added to the linker flags to disable this feature.
@node Program execution,Running gprof,Compilation for profiling,Profiling an
Ada Program with gprof
-@anchor{gnat_ugn/gnat_and_program_execution
id23}@anchor{177}@anchor{gnat_ugn/gnat_and_program_execution
program-execution}@anchor{178}
+@anchor{gnat_ugn/gnat_and_program_execution
id23}@anchor{178}@anchor{gnat_ugn/gnat_and_program_execution
program-execution}@anchor{179}
@subsubsection Program execution
@@ -19790,7 +19812,7 @@ generated in the directory where the program was
launched from. If this file
already exists, it will be overwritten.
@node Running gprof,Interpretation of profiling results,Program
execution,Profiling an Ada Program with gprof
-@anchor{gnat_ugn/gnat_and_program_execution
id24}@anchor{179}@anchor{gnat_ugn/gnat_and_program_execution
running-gprof}@anchor{17a}
+@anchor{gnat_ugn/gnat_and_program_execution
id24}@anchor{17a}@anchor{gnat_ugn/gnat_and_program_execution
running-gprof}@anchor{17b}
@subsubsection Running gprof
@@ -19903,7 +19925,7 @@ may be given; only one @code{function_name} may be
indicated with each
@end table
@node Interpretation of profiling results,,Running gprof,Profiling an Ada
Program with gprof
-@anchor{gnat_ugn/gnat_and_program_execution
id25}@anchor{17b}@anchor{gnat_ugn/gnat_and_program_execution
interpretation-of-profiling-results}@anchor{17c}
+@anchor{gnat_ugn/gnat_and_program_execution
id25}@anchor{17c}@anchor{gnat_ugn/gnat_and_program_execution
interpretation-of-profiling-results}@anchor{17d}
@subsubsection Interpretation of profiling results
@@ -19920,7 +19942,7 @@ and the subprograms that it calls. It also provides an
estimate of the time
spent in each of those callers/called subprograms.
@node Improving Performance,Overflow Check Handling in GNAT,Profiling,GNAT and
Program Execution
-@anchor{gnat_ugn/gnat_and_program_execution
id26}@anchor{14a}@anchor{gnat_ugn/gnat_and_program_execution
improving-performance}@anchor{17d}
+@anchor{gnat_ugn/gnat_and_program_execution
id26}@anchor{14b}@anchor{gnat_ugn/gnat_and_program_execution
improving-performance}@anchor{17e}
@section Improving Performance
@@ -19941,7 +19963,7 @@ which can reduce the size of program executables.
@end menu
@node Performance Considerations,Text_IO Suggestions,,Improving Performance
-@anchor{gnat_ugn/gnat_and_program_execution
id27}@anchor{17e}@anchor{gnat_ugn/gnat_and_program_execution
performance-considerations}@anchor{17f}
+@anchor{gnat_ugn/gnat_and_program_execution
id27}@anchor{17f}@anchor{gnat_ugn/gnat_and_program_execution
performance-considerations}@anchor{180}
@subsection Performance Considerations
@@ -20002,7 +20024,7 @@ some guidelines on debugging optimized code.
@end menu
@node Controlling Run-Time Checks,Use of Restrictions,,Performance
Considerations
-@anchor{gnat_ugn/gnat_and_program_execution
controlling-run-time-checks}@anchor{180}@anchor{gnat_ugn/gnat_and_program_execution
id28}@anchor{181}
+@anchor{gnat_ugn/gnat_and_program_execution
controlling-run-time-checks}@anchor{181}@anchor{gnat_ugn/gnat_and_program_execution
id28}@anchor{182}
@subsubsection Controlling Run-Time Checks
@@ -20054,7 +20076,7 @@ remove checks) or @code{pragma Unsuppress} (to add back
suppressed
checks) in the program source.
@node Use of Restrictions,Optimization Levels,Controlling Run-Time
Checks,Performance Considerations
-@anchor{gnat_ugn/gnat_and_program_execution
id29}@anchor{182}@anchor{gnat_ugn/gnat_and_program_execution
use-of-restrictions}@anchor{183}
+@anchor{gnat_ugn/gnat_and_program_execution
id29}@anchor{183}@anchor{gnat_ugn/gnat_and_program_execution
use-of-restrictions}@anchor{184}
@subsubsection Use of Restrictions
@@ -20089,7 +20111,7 @@ that this also means that you can write code without
worrying about the
possibility of an immediate abort at any point.
@node Optimization Levels,Debugging Optimized Code,Use of
Restrictions,Performance Considerations
-@anchor{gnat_ugn/gnat_and_program_execution
id30}@anchor{184}@anchor{gnat_ugn/gnat_and_program_execution
optimization-levels}@anchor{ef}
+@anchor{gnat_ugn/gnat_and_program_execution
id30}@anchor{185}@anchor{gnat_ugn/gnat_and_program_execution
optimization-levels}@anchor{ef}
@subsubsection Optimization Levels
@@ -20170,7 +20192,7 @@ the slowest compilation time.
Full optimization as in @code{-O2};
also uses more aggressive automatic inlining of subprograms within a unit
-(@ref{102,,Inlining of Subprograms}) and attempts to vectorize loops.
+(@ref{103,,Inlining of Subprograms}) and attempts to vectorize loops.
@end table
@item
@@ -20210,10 +20232,10 @@ levels.
Note regarding the use of @code{-O3}: The use of this optimization level
ought not to be automatically preferred over that of level @code{-O2},
since it often results in larger executables which may run more slowly.
-See further discussion of this point in @ref{102,,Inlining of Subprograms}.
+See further discussion of this point in @ref{103,,Inlining of Subprograms}.
@node Debugging Optimized Code,Inlining of Subprograms,Optimization
Levels,Performance Considerations
-@anchor{gnat_ugn/gnat_and_program_execution
debugging-optimized-code}@anchor{185}@anchor{gnat_ugn/gnat_and_program_execution
id31}@anchor{186}
+@anchor{gnat_ugn/gnat_and_program_execution
debugging-optimized-code}@anchor{186}@anchor{gnat_ugn/gnat_and_program_execution
id31}@anchor{187}
@subsubsection Debugging Optimized Code
@@ -20341,7 +20363,7 @@ on the resulting executable,
which removes both debugging information and global symbols.
@node Inlining of Subprograms,Floating Point Operations,Debugging Optimized
Code,Performance Considerations
-@anchor{gnat_ugn/gnat_and_program_execution
id32}@anchor{187}@anchor{gnat_ugn/gnat_and_program_execution
inlining-of-subprograms}@anchor{102}
+@anchor{gnat_ugn/gnat_and_program_execution
id32}@anchor{188}@anchor{gnat_ugn/gnat_and_program_execution
inlining-of-subprograms}@anchor{103}
@subsubsection Inlining of Subprograms
@@ -20480,7 +20502,7 @@ indeed you should use @code{-O3} only if tests show
that it actually
improves performance for your program.
@node Floating Point Operations,Vectorization of loops,Inlining of
Subprograms,Performance Considerations
-@anchor{gnat_ugn/gnat_and_program_execution
floating-point-operations}@anchor{188}@anchor{gnat_ugn/gnat_and_program_execution
id33}@anchor{189}
+@anchor{gnat_ugn/gnat_and_program_execution
floating-point-operations}@anchor{189}@anchor{gnat_ugn/gnat_and_program_execution
id33}@anchor{18a}
@subsubsection Floating Point Operations
@@ -20528,7 +20550,7 @@ so it is permissible to mix units compiled with and
without these
switches.
@node Vectorization of loops,Other Optimization Switches,Floating Point
Operations,Performance Considerations
-@anchor{gnat_ugn/gnat_and_program_execution
id34}@anchor{18a}@anchor{gnat_ugn/gnat_and_program_execution
vectorization-of-loops}@anchor{18b}
+@anchor{gnat_ugn/gnat_and_program_execution
id34}@anchor{18b}@anchor{gnat_ugn/gnat_and_program_execution
vectorization-of-loops}@anchor{18c}
@subsubsection Vectorization of loops
@@ -20679,7 +20701,7 @@ placed immediately within the loop will tell the
compiler that it can safely
omit the non-vectorized version of the loop as well as the run-time test.
@node Other Optimization Switches,Optimization and Strict
Aliasing,Vectorization of loops,Performance Considerations
-@anchor{gnat_ugn/gnat_and_program_execution
id35}@anchor{18c}@anchor{gnat_ugn/gnat_and_program_execution
other-optimization-switches}@anchor{18d}
+@anchor{gnat_ugn/gnat_and_program_execution
id35}@anchor{18d}@anchor{gnat_ugn/gnat_and_program_execution
other-optimization-switches}@anchor{18e}
@subsubsection Other Optimization Switches
@@ -20696,7 +20718,7 @@ the `Submodel Options' section in the `Hardware Models
and Configurations'
chapter of @cite{Using the GNU Compiler Collection (GCC)}.
@node Optimization and Strict Aliasing,Aliased Variables and
Optimization,Other Optimization Switches,Performance Considerations
-@anchor{gnat_ugn/gnat_and_program_execution
id36}@anchor{18e}@anchor{gnat_ugn/gnat_and_program_execution
optimization-and-strict-aliasing}@anchor{e6}
+@anchor{gnat_ugn/gnat_and_program_execution
id36}@anchor{18f}@anchor{gnat_ugn/gnat_and_program_execution
optimization-and-strict-aliasing}@anchor{e6}
@subsubsection Optimization and Strict Aliasing
@@ -20988,7 +21010,7 @@ review any uses of unchecked conversion, particularly
if you are
getting the warnings described above.
@node Aliased Variables and Optimization,Atomic Variables and
Optimization,Optimization and Strict Aliasing,Performance Considerations
-@anchor{gnat_ugn/gnat_and_program_execution
aliased-variables-and-optimization}@anchor{18f}@anchor{gnat_ugn/gnat_and_program_execution
id37}@anchor{190}
+@anchor{gnat_ugn/gnat_and_program_execution
aliased-variables-and-optimization}@anchor{190}@anchor{gnat_ugn/gnat_and_program_execution
id37}@anchor{191}
@subsubsection Aliased Variables and Optimization
@@ -21046,7 +21068,7 @@ This means that the above example will in fact “work”
reliably,
that is, it will produce the expected results.
@node Atomic Variables and Optimization,Passive Task Optimization,Aliased
Variables and Optimization,Performance Considerations
-@anchor{gnat_ugn/gnat_and_program_execution
atomic-variables-and-optimization}@anchor{191}@anchor{gnat_ugn/gnat_and_program_execution
id38}@anchor{192}
+@anchor{gnat_ugn/gnat_and_program_execution
atomic-variables-and-optimization}@anchor{192}@anchor{gnat_ugn/gnat_and_program_execution
id38}@anchor{193}
@subsubsection Atomic Variables and Optimization
@@ -21127,7 +21149,7 @@ such synchronization code is not required, it may be
useful to disable it.
@node Passive Task Optimization,,Atomic Variables and Optimization,Performance
Considerations
-@anchor{gnat_ugn/gnat_and_program_execution
id39}@anchor{193}@anchor{gnat_ugn/gnat_and_program_execution
passive-task-optimization}@anchor{194}
+@anchor{gnat_ugn/gnat_and_program_execution
id39}@anchor{194}@anchor{gnat_ugn/gnat_and_program_execution
passive-task-optimization}@anchor{195}
@subsubsection Passive Task Optimization
@@ -21172,7 +21194,7 @@ that typically clients of the tasks who call entries,
will not have
to be modified, only the task definition itself.
@node Text_IO Suggestions,Reducing Size of Executables with Unused
Subprogram/Data Elimination,Performance Considerations,Improving Performance
-@anchor{gnat_ugn/gnat_and_program_execution
id40}@anchor{195}@anchor{gnat_ugn/gnat_and_program_execution
text-io-suggestions}@anchor{196}
+@anchor{gnat_ugn/gnat_and_program_execution
id40}@anchor{196}@anchor{gnat_ugn/gnat_and_program_execution
text-io-suggestions}@anchor{197}
@subsection @code{Text_IO} Suggestions
@@ -21195,7 +21217,7 @@ of the standard output file, or change the standard
output file to
be buffered using @code{Interfaces.C_Streams.setvbuf}.
@node Reducing Size of Executables with Unused Subprogram/Data
Elimination,,Text_IO Suggestions,Improving Performance
-@anchor{gnat_ugn/gnat_and_program_execution
id41}@anchor{197}@anchor{gnat_ugn/gnat_and_program_execution
reducing-size-of-executables-with-unused-subprogram-data-elimination}@anchor{198}
+@anchor{gnat_ugn/gnat_and_program_execution
id41}@anchor{198}@anchor{gnat_ugn/gnat_and_program_execution
reducing-size-of-executables-with-unused-subprogram-data-elimination}@anchor{199}
@subsection Reducing Size of Executables with Unused Subprogram/Data
Elimination
@@ -21212,7 +21234,7 @@ your executable just by setting options at compilation
time.
@end menu
@node About unused subprogram/data elimination,Compilation options,,Reducing
Size of Executables with Unused Subprogram/Data Elimination
-@anchor{gnat_ugn/gnat_and_program_execution
about-unused-subprogram-data-elimination}@anchor{199}@anchor{gnat_ugn/gnat_and_program_execution
id42}@anchor{19a}
+@anchor{gnat_ugn/gnat_and_program_execution
about-unused-subprogram-data-elimination}@anchor{19a}@anchor{gnat_ugn/gnat_and_program_execution
id42}@anchor{19b}
@subsubsection About unused subprogram/data elimination
@@ -21228,7 +21250,7 @@ architecture and on all cross platforms using the ELF
binary file format.
In both cases GNU binutils version 2.16 or later are required to enable it.
@node Compilation options,Example of unused subprogram/data elimination,About
unused subprogram/data elimination,Reducing Size of Executables with Unused
Subprogram/Data Elimination
-@anchor{gnat_ugn/gnat_and_program_execution
compilation-options}@anchor{19b}@anchor{gnat_ugn/gnat_and_program_execution
id43}@anchor{19c}
+@anchor{gnat_ugn/gnat_and_program_execution
compilation-options}@anchor{19c}@anchor{gnat_ugn/gnat_and_program_execution
id43}@anchor{19d}
@subsubsection Compilation options
@@ -21267,7 +21289,7 @@ The GNAT static library is now compiled with
-ffunction-sections and
and data of the GNAT library from your executable.
@node Example of unused subprogram/data elimination,,Compilation
options,Reducing Size of Executables with Unused Subprogram/Data Elimination
-@anchor{gnat_ugn/gnat_and_program_execution
example-of-unused-subprogram-data-elimination}@anchor{19d}@anchor{gnat_ugn/gnat_and_program_execution
id44}@anchor{19e}
+@anchor{gnat_ugn/gnat_and_program_execution
example-of-unused-subprogram-data-elimination}@anchor{19e}@anchor{gnat_ugn/gnat_and_program_execution
id44}@anchor{19f}
@subsubsection Example of unused subprogram/data elimination
@@ -21337,7 +21359,7 @@ appropriate options.
@geindex Checks (overflow)
@node Overflow Check Handling in GNAT,Performing Dimensionality Analysis in
GNAT,Improving Performance,GNAT and Program Execution
-@anchor{gnat_ugn/gnat_and_program_execution
id45}@anchor{14b}@anchor{gnat_ugn/gnat_and_program_execution
overflow-check-handling-in-gnat}@anchor{19f}
+@anchor{gnat_ugn/gnat_and_program_execution
id45}@anchor{14c}@anchor{gnat_ugn/gnat_and_program_execution
overflow-check-handling-in-gnat}@anchor{1a0}
@section Overflow Check Handling in GNAT
@@ -21353,7 +21375,7 @@ This section explains how to control the handling of
overflow checks.
@end menu
@node Background,Management of Overflows in GNAT,,Overflow Check Handling in
GNAT
-@anchor{gnat_ugn/gnat_and_program_execution
background}@anchor{1a0}@anchor{gnat_ugn/gnat_and_program_execution
id46}@anchor{1a1}
+@anchor{gnat_ugn/gnat_and_program_execution
background}@anchor{1a1}@anchor{gnat_ugn/gnat_and_program_execution
id46}@anchor{1a2}
@subsection Background
@@ -21479,7 +21501,7 @@ exception raised because of the intermediate overflow
(and we really
would prefer this precondition to be considered True at run time).
@node Management of Overflows in GNAT,Specifying the Desired
Mode,Background,Overflow Check Handling in GNAT
-@anchor{gnat_ugn/gnat_and_program_execution
id47}@anchor{1a2}@anchor{gnat_ugn/gnat_and_program_execution
management-of-overflows-in-gnat}@anchor{1a3}
+@anchor{gnat_ugn/gnat_and_program_execution
id47}@anchor{1a3}@anchor{gnat_ugn/gnat_and_program_execution
management-of-overflows-in-gnat}@anchor{1a4}
@subsection Management of Overflows in GNAT
@@ -21593,7 +21615,7 @@ out in the normal manner (with infinite values always
failing all
range checks).
@node Specifying the Desired Mode,Default Settings,Management of Overflows in
GNAT,Overflow Check Handling in GNAT
-@anchor{gnat_ugn/gnat_and_program_execution
id48}@anchor{1a4}@anchor{gnat_ugn/gnat_and_program_execution
specifying-the-desired-mode}@anchor{eb}
+@anchor{gnat_ugn/gnat_and_program_execution
id48}@anchor{1a5}@anchor{gnat_ugn/gnat_and_program_execution
specifying-the-desired-mode}@anchor{eb}
@subsection Specifying the Desired Mode
@@ -21717,7 +21739,7 @@ causing all intermediate operations to be computed
using the base
type (@code{STRICT} mode).
@node Default Settings,Implementation Notes,Specifying the Desired
Mode,Overflow Check Handling in GNAT
-@anchor{gnat_ugn/gnat_and_program_execution
default-settings}@anchor{1a5}@anchor{gnat_ugn/gnat_and_program_execution
id49}@anchor{1a6}
+@anchor{gnat_ugn/gnat_and_program_execution
default-settings}@anchor{1a6}@anchor{gnat_ugn/gnat_and_program_execution
id49}@anchor{1a7}
@subsection Default Settings
@@ -21742,7 +21764,7 @@ checking, but it has no effect on the method used for
computing
intermediate results.
@node Implementation Notes,,Default Settings,Overflow Check Handling in GNAT
-@anchor{gnat_ugn/gnat_and_program_execution
id50}@anchor{1a7}@anchor{gnat_ugn/gnat_and_program_execution
implementation-notes}@anchor{1a8}
+@anchor{gnat_ugn/gnat_and_program_execution
id50}@anchor{1a8}@anchor{gnat_ugn/gnat_and_program_execution
implementation-notes}@anchor{1a9}
@subsection Implementation Notes
@@ -21790,7 +21812,7 @@ platforms for which @code{Long_Long_Integer} is 64-bits
(nearly all GNAT
platforms).
@node Performing Dimensionality Analysis in GNAT,Stack Related
Facilities,Overflow Check Handling in GNAT,GNAT and Program Execution
-@anchor{gnat_ugn/gnat_and_program_execution
id51}@anchor{14c}@anchor{gnat_ugn/gnat_and_program_execution
performing-dimensionality-analysis-in-gnat}@anchor{1a9}
+@anchor{gnat_ugn/gnat_and_program_execution
id51}@anchor{14d}@anchor{gnat_ugn/gnat_and_program_execution
performing-dimensionality-analysis-in-gnat}@anchor{1aa}
@section Performing Dimensionality Analysis in GNAT
@@ -22193,7 +22215,7 @@ package Mks_Numerics is new
@end quotation
@node Stack Related Facilities,Memory Management Issues,Performing
Dimensionality Analysis in GNAT,GNAT and Program Execution
-@anchor{gnat_ugn/gnat_and_program_execution
id52}@anchor{14d}@anchor{gnat_ugn/gnat_and_program_execution
stack-related-facilities}@anchor{1aa}
+@anchor{gnat_ugn/gnat_and_program_execution
id52}@anchor{14e}@anchor{gnat_ugn/gnat_and_program_execution
stack-related-facilities}@anchor{1ab}
@section Stack Related Facilities
@@ -22209,7 +22231,7 @@ particular, it deals with dynamic and static stack
usage measurements.
@end menu
@node Stack Overflow Checking,Static Stack Usage Analysis,,Stack Related
Facilities
-@anchor{gnat_ugn/gnat_and_program_execution
id53}@anchor{1ab}@anchor{gnat_ugn/gnat_and_program_execution
stack-overflow-checking}@anchor{e7}
+@anchor{gnat_ugn/gnat_and_program_execution
id53}@anchor{1ac}@anchor{gnat_ugn/gnat_and_program_execution
stack-overflow-checking}@anchor{e7}
@subsection Stack Overflow Checking
@@ -22246,7 +22268,7 @@ If the space is exceeded, then a @code{Storage_Error}
exception is raised.
For declared tasks, the default stack size is defined by the GNAT runtime,
whose size may be modified at bind time through the @code{-d} bind switch
-(@ref{112,,Switches for gnatbind}). Task specific stack sizes may be set using
the
+(@ref{113,,Switches for gnatbind}). Task specific stack sizes may be set using
the
@code{Storage_Size} pragma.
For the environment task, the stack size is determined by the operating system.
@@ -22254,7 +22276,7 @@ Consequently, to modify the size of the environment
task please refer to your
operating system documentation.
@node Static Stack Usage Analysis,Dynamic Stack Usage Analysis,Stack Overflow
Checking,Stack Related Facilities
-@anchor{gnat_ugn/gnat_and_program_execution
id54}@anchor{1ac}@anchor{gnat_ugn/gnat_and_program_execution
static-stack-usage-analysis}@anchor{e8}
+@anchor{gnat_ugn/gnat_and_program_execution
id54}@anchor{1ad}@anchor{gnat_ugn/gnat_and_program_execution
static-stack-usage-analysis}@anchor{e8}
@subsection Static Stack Usage Analysis
@@ -22303,7 +22325,7 @@ subprogram whose stack usage might be larger than the
specified amount of
bytes. The wording is in keeping with the qualifier documented above.
@node Dynamic Stack Usage Analysis,,Static Stack Usage Analysis,Stack Related
Facilities
-@anchor{gnat_ugn/gnat_and_program_execution
dynamic-stack-usage-analysis}@anchor{115}@anchor{gnat_ugn/gnat_and_program_execution
id55}@anchor{1ad}
+@anchor{gnat_ugn/gnat_and_program_execution
dynamic-stack-usage-analysis}@anchor{116}@anchor{gnat_ugn/gnat_and_program_execution
id55}@anchor{1ae}
@subsection Dynamic Stack Usage Analysis
@@ -22385,7 +22407,7 @@ The package @code{GNAT.Task_Stack_Usage} provides
facilities to get
stack-usage reports at run time. See its body for the details.
@node Memory Management Issues,,Stack Related Facilities,GNAT and Program
Execution
-@anchor{gnat_ugn/gnat_and_program_execution
id56}@anchor{14e}@anchor{gnat_ugn/gnat_and_program_execution
memory-management-issues}@anchor{1ae}
+@anchor{gnat_ugn/gnat_and_program_execution
id56}@anchor{14f}@anchor{gnat_ugn/gnat_and_program_execution
memory-management-issues}@anchor{1af}
@section Memory Management Issues
@@ -22401,7 +22423,7 @@ incorrect uses of access values (including ‘dangling
references’).
@end menu
@node Some Useful Memory Pools,The GNAT Debug Pool Facility,,Memory Management
Issues
-@anchor{gnat_ugn/gnat_and_program_execution
id57}@anchor{1af}@anchor{gnat_ugn/gnat_and_program_execution
some-useful-memory-pools}@anchor{1b0}
+@anchor{gnat_ugn/gnat_and_program_execution
id57}@anchor{1b0}@anchor{gnat_ugn/gnat_and_program_execution
some-useful-memory-pools}@anchor{1b1}
@subsection Some Useful Memory Pools
@@ -22482,7 +22504,7 @@ for T1'Storage_Size use 10_000;
@end quotation
@node The GNAT Debug Pool Facility,,Some Useful Memory Pools,Memory Management
Issues
-@anchor{gnat_ugn/gnat_and_program_execution
id58}@anchor{1b1}@anchor{gnat_ugn/gnat_and_program_execution
the-gnat-debug-pool-facility}@anchor{1b2}
+@anchor{gnat_ugn/gnat_and_program_execution
id58}@anchor{1b2}@anchor{gnat_ugn/gnat_and_program_execution
the-gnat-debug-pool-facility}@anchor{1b3}
@subsection The GNAT Debug Pool Facility
@@ -22645,7 +22667,7 @@ Debug Pool info:
@c -- E.g. Ada |nbsp| 95
@node Platform-Specific Information,Example of Binder Output File,GNAT and
Program Execution,Top
-@anchor{gnat_ugn/platform_specific_information
doc}@anchor{1b3}@anchor{gnat_ugn/platform_specific_information
id1}@anchor{1b4}@anchor{gnat_ugn/platform_specific_information
platform-specific-information}@anchor{d}
+@anchor{gnat_ugn/platform_specific_information
doc}@anchor{1b4}@anchor{gnat_ugn/platform_specific_information
id1}@anchor{1b5}@anchor{gnat_ugn/platform_specific_information
platform-specific-information}@anchor{d}
@chapter Platform-Specific Information
@@ -22663,7 +22685,7 @@ related to the GNAT implementation on specific
Operating Systems.
@end menu
@node Run-Time Libraries,Specifying a Run-Time Library,,Platform-Specific
Information
-@anchor{gnat_ugn/platform_specific_information
id2}@anchor{1b5}@anchor{gnat_ugn/platform_specific_information
run-time-libraries}@anchor{1b6}
+@anchor{gnat_ugn/platform_specific_information
id2}@anchor{1b6}@anchor{gnat_ugn/platform_specific_information
run-time-libraries}@anchor{1b7}
@section Run-Time Libraries
@@ -22724,7 +22746,7 @@ are supplied on various GNAT platforms.
@end menu
@node Summary of Run-Time Configurations,,,Run-Time Libraries
-@anchor{gnat_ugn/platform_specific_information
id3}@anchor{1b7}@anchor{gnat_ugn/platform_specific_information
summary-of-run-time-configurations}@anchor{1b8}
+@anchor{gnat_ugn/platform_specific_information
id3}@anchor{1b8}@anchor{gnat_ugn/platform_specific_information
summary-of-run-time-configurations}@anchor{1b9}
@subsection Summary of Run-Time Configurations
@@ -22824,7 +22846,7 @@ ZCX
@node Specifying a Run-Time Library,GNU/Linux Topics,Run-Time
Libraries,Platform-Specific Information
-@anchor{gnat_ugn/platform_specific_information
id4}@anchor{1b9}@anchor{gnat_ugn/platform_specific_information
specifying-a-run-time-library}@anchor{1ba}
+@anchor{gnat_ugn/platform_specific_information
id4}@anchor{1ba}@anchor{gnat_ugn/platform_specific_information
specifying-a-run-time-library}@anchor{1bb}
@section Specifying a Run-Time Library
@@ -22917,7 +22939,7 @@ achieved by using the @code{--RTS} switch, e.g.,
@code{--RTS=sjlj}
@geindex GNU/Linux
@node GNU/Linux Topics,Microsoft Windows Topics,Specifying a Run-Time
Library,Platform-Specific Information
-@anchor{gnat_ugn/platform_specific_information
gnu-linux-topics}@anchor{1bb}@anchor{gnat_ugn/platform_specific_information
id5}@anchor{1bc}
+@anchor{gnat_ugn/platform_specific_information
gnu-linux-topics}@anchor{1bc}@anchor{gnat_ugn/platform_specific_information
id5}@anchor{1bd}
@section GNU/Linux Topics
@@ -22932,7 +22954,7 @@ This section describes topics that are specific to
GNU/Linux platforms.
@end menu
@node Required Packages on GNU/Linux,Position Independent Executable PIE
Enabled by Default on Linux,,GNU/Linux Topics
-@anchor{gnat_ugn/platform_specific_information
id6}@anchor{1bd}@anchor{gnat_ugn/platform_specific_information
required-packages-on-gnu-linux}@anchor{1be}
+@anchor{gnat_ugn/platform_specific_information
id6}@anchor{1be}@anchor{gnat_ugn/platform_specific_information
required-packages-on-gnu-linux}@anchor{1bf}
@subsection Required Packages on GNU/Linux
@@ -22969,7 +22991,7 @@ Other GNU/Linux distributions might be choosing a
different name
for those packages.
@node Position Independent Executable PIE Enabled by Default on Linux,Choosing
the Scheduling Policy with GNU/Linux,Required Packages on GNU/Linux,GNU/Linux
Topics
-@anchor{gnat_ugn/platform_specific_information
pie-enabled-by-default-on-linux}@anchor{1bf}@anchor{gnat_ugn/platform_specific_information
position-independent-executable-pie-enabled-by-default-on-linux}@anchor{1c0}
+@anchor{gnat_ugn/platform_specific_information
pie-enabled-by-default-on-linux}@anchor{1c0}@anchor{gnat_ugn/platform_specific_information
position-independent-executable-pie-enabled-by-default-on-linux}@anchor{1c1}
@subsection Position Independent Executable (PIE) Enabled by Default on Linux
@@ -23011,7 +23033,7 @@ From there, to be able to link your binaries with PIE
and therefore
drop the @code{-no-pie} workaround, you’ll need to get the identified
dependencies rebuilt with PIE enabled (compiled with @code{-fPIE}
and linked with @code{-pie}).
-@anchor{gnat_ugn/platform_specific_information
choosing-the-scheduling-policy-with-gnu-linux}@anchor{1c1}
+@anchor{gnat_ugn/platform_specific_information
choosing-the-scheduling-policy-with-gnu-linux}@anchor{1c2}
@geindex SCHED_FIFO scheduling policy
@geindex SCHED_RR scheduling policy
@@ -23019,7 +23041,7 @@ and linked with @code{-pie}).
@geindex SCHED_OTHER scheduling policy
@node Choosing the Scheduling Policy with GNU/Linux,A GNU/Linux Debug
Quirk,Position Independent Executable PIE Enabled by Default on Linux,GNU/Linux
Topics
-@anchor{gnat_ugn/platform_specific_information id7}@anchor{1c2}
+@anchor{gnat_ugn/platform_specific_information id7}@anchor{1c3}
@subsection Choosing the Scheduling Policy with GNU/Linux
@@ -23077,7 +23099,7 @@ but not on the host machine running the container, so
check that you also
have sufficient priviledge for running the container image.
@node A GNU/Linux Debug Quirk,,Choosing the Scheduling Policy with
GNU/Linux,GNU/Linux Topics
-@anchor{gnat_ugn/platform_specific_information
a-gnu-linux-debug-quirk}@anchor{1c3}@anchor{gnat_ugn/platform_specific_information
id8}@anchor{1c4}
+@anchor{gnat_ugn/platform_specific_information
a-gnu-linux-debug-quirk}@anchor{1c4}@anchor{gnat_ugn/platform_specific_information
id8}@anchor{1c5}
@subsection A GNU/Linux Debug Quirk
@@ -23097,7 +23119,7 @@ the symptoms most commonly observed.
@geindex Windows
@node Microsoft Windows Topics,Mac OS Topics,GNU/Linux
Topics,Platform-Specific Information
-@anchor{gnat_ugn/platform_specific_information
id9}@anchor{1c5}@anchor{gnat_ugn/platform_specific_information
microsoft-windows-topics}@anchor{1c6}
+@anchor{gnat_ugn/platform_specific_information
id9}@anchor{1c6}@anchor{gnat_ugn/platform_specific_information
microsoft-windows-topics}@anchor{1c7}
@section Microsoft Windows Topics
@@ -23119,7 +23141,7 @@ platforms.
@end menu
@node Using GNAT on Windows,Using a network installation of GNAT,,Microsoft
Windows Topics
-@anchor{gnat_ugn/platform_specific_information
id10}@anchor{1c7}@anchor{gnat_ugn/platform_specific_information
using-gnat-on-windows}@anchor{1c8}
+@anchor{gnat_ugn/platform_specific_information
id10}@anchor{1c8}@anchor{gnat_ugn/platform_specific_information
using-gnat-on-windows}@anchor{1c9}
@subsection Using GNAT on Windows
@@ -23196,7 +23218,7 @@ uninstall or integrate different GNAT products.
@end itemize
@node Using a network installation of GNAT,CONSOLE and WINDOWS
subsystems,Using GNAT on Windows,Microsoft Windows Topics
-@anchor{gnat_ugn/platform_specific_information
id11}@anchor{1c9}@anchor{gnat_ugn/platform_specific_information
using-a-network-installation-of-gnat}@anchor{1ca}
+@anchor{gnat_ugn/platform_specific_information
id11}@anchor{1ca}@anchor{gnat_ugn/platform_specific_information
using-a-network-installation-of-gnat}@anchor{1cb}
@subsection Using a network installation of GNAT
@@ -23223,7 +23245,7 @@ transfer of large amounts of data across the network
and will likely cause
serious performance penalty.
@node CONSOLE and WINDOWS subsystems,Temporary Files,Using a network
installation of GNAT,Microsoft Windows Topics
-@anchor{gnat_ugn/platform_specific_information
console-and-windows-subsystems}@anchor{1cb}@anchor{gnat_ugn/platform_specific_information
id12}@anchor{1cc}
+@anchor{gnat_ugn/platform_specific_information
console-and-windows-subsystems}@anchor{1cc}@anchor{gnat_ugn/platform_specific_information
id12}@anchor{1cd}
@subsection CONSOLE and WINDOWS subsystems
@@ -23248,7 +23270,7 @@ $ gnatmake winprog -largs -mwindows
@end quotation
@node Temporary Files,Disabling Command Line Argument Expansion,CONSOLE and
WINDOWS subsystems,Microsoft Windows Topics
-@anchor{gnat_ugn/platform_specific_information
id13}@anchor{1cd}@anchor{gnat_ugn/platform_specific_information
temporary-files}@anchor{1ce}
+@anchor{gnat_ugn/platform_specific_information
id13}@anchor{1ce}@anchor{gnat_ugn/platform_specific_information
temporary-files}@anchor{1cf}
@subsection Temporary Files
@@ -23287,7 +23309,7 @@ environments where you may not have write access to some
directories.
@node Disabling Command Line Argument Expansion,Choosing the Scheduling Policy
with Windows,Temporary Files,Microsoft Windows Topics
-@anchor{gnat_ugn/platform_specific_information
disabling-command-line-argument-expansion}@anchor{1cf}
+@anchor{gnat_ugn/platform_specific_information
disabling-command-line-argument-expansion}@anchor{1d0}
@subsection Disabling Command Line Argument Expansion
@@ -23358,7 +23380,7 @@ Ada.Command_Line.Argument (1) -> "'*.txt'"
@end example
@node Choosing the Scheduling Policy with Windows,Windows Socket
Timeouts,Disabling Command Line Argument Expansion,Microsoft Windows Topics
-@anchor{gnat_ugn/platform_specific_information
choosing-the-scheduling-policy-with-windows}@anchor{1d0}@anchor{gnat_ugn/platform_specific_information
id14}@anchor{1d1}
+@anchor{gnat_ugn/platform_specific_information
choosing-the-scheduling-policy-with-windows}@anchor{1d1}@anchor{gnat_ugn/platform_specific_information
id14}@anchor{1d2}
@subsection Choosing the Scheduling Policy with Windows
@@ -23376,7 +23398,7 @@ in @code{system.ads}. For more information about
Windows priorities, please
refer to Microsoft’s documentation.
@node Windows Socket Timeouts,Mixed-Language Programming on Windows,Choosing
the Scheduling Policy with Windows,Microsoft Windows Topics
-@anchor{gnat_ugn/platform_specific_information
windows-socket-timeouts}@anchor{1d2}
+@anchor{gnat_ugn/platform_specific_information
windows-socket-timeouts}@anchor{1d3}
@subsection Windows Socket Timeouts
@@ -23422,7 +23444,7 @@ shorter than 500 ms is needed on these Windows
versions, a call to
Check_Selector should be added before any socket read or write operations.
@node Mixed-Language Programming on Windows,Windows Specific Add-Ons,Windows
Socket Timeouts,Microsoft Windows Topics
-@anchor{gnat_ugn/platform_specific_information
id15}@anchor{1d3}@anchor{gnat_ugn/platform_specific_information
mixed-language-programming-on-windows}@anchor{1d4}
+@anchor{gnat_ugn/platform_specific_information
id15}@anchor{1d4}@anchor{gnat_ugn/platform_specific_information
mixed-language-programming-on-windows}@anchor{1d5}
@subsection Mixed-Language Programming on Windows
@@ -23444,12 +23466,12 @@ to use the Microsoft tools for your C++ code, you
have two choices:
Encapsulate your C++ code in a DLL to be linked with your Ada
application. In this case, use the Microsoft or whatever environment to
build the DLL and use GNAT to build your executable
-(@ref{1d5,,Using DLLs with GNAT}).
+(@ref{1d6,,Using DLLs with GNAT}).
@item
Or you can encapsulate your Ada code in a DLL to be linked with the
other part of your application. In this case, use GNAT to build the DLL
-(@ref{1d6,,Building DLLs with GNAT Project files}) and use the Microsoft
+(@ref{1d7,,Building DLLs with GNAT Project files}) and use the Microsoft
or whatever environment to build your executable.
@end itemize
@@ -23506,7 +23528,7 @@ native SEH support is used.
@end menu
@node Windows Calling Conventions,Introduction to Dynamic Link Libraries
DLLs,,Mixed-Language Programming on Windows
-@anchor{gnat_ugn/platform_specific_information
id16}@anchor{1d7}@anchor{gnat_ugn/platform_specific_information
windows-calling-conventions}@anchor{1d8}
+@anchor{gnat_ugn/platform_specific_information
id16}@anchor{1d8}@anchor{gnat_ugn/platform_specific_information
windows-calling-conventions}@anchor{1d9}
@subsubsection Windows Calling Conventions
@@ -23551,7 +23573,7 @@ are available for Windows:
@end menu
@node C Calling Convention,Stdcall Calling Convention,,Windows Calling
Conventions
-@anchor{gnat_ugn/platform_specific_information
c-calling-convention}@anchor{1d9}@anchor{gnat_ugn/platform_specific_information
id17}@anchor{1da}
+@anchor{gnat_ugn/platform_specific_information
c-calling-convention}@anchor{1da}@anchor{gnat_ugn/platform_specific_information
id17}@anchor{1db}
@subsubsection @code{C} Calling Convention
@@ -23593,10 +23615,10 @@ is missing, as in the above example, this parameter
is set to be the
When importing a variable defined in C, you should always use the @code{C}
calling convention unless the object containing the variable is part of a
DLL (in which case you should use the @code{Stdcall} calling
-convention, @ref{1db,,Stdcall Calling Convention}).
+convention, @ref{1dc,,Stdcall Calling Convention}).
@node Stdcall Calling Convention,Win32 Calling Convention,C Calling
Convention,Windows Calling Conventions
-@anchor{gnat_ugn/platform_specific_information
id18}@anchor{1dc}@anchor{gnat_ugn/platform_specific_information
stdcall-calling-convention}@anchor{1db}
+@anchor{gnat_ugn/platform_specific_information
id18}@anchor{1dd}@anchor{gnat_ugn/platform_specific_information
stdcall-calling-convention}@anchor{1dc}
@subsubsection @code{Stdcall} Calling Convention
@@ -23693,7 +23715,7 @@ Note that to ease building cross-platform bindings this
convention
will be handled as a @code{C} calling convention on non-Windows platforms.
@node Win32 Calling Convention,DLL Calling Convention,Stdcall Calling
Convention,Windows Calling Conventions
-@anchor{gnat_ugn/platform_specific_information
id19}@anchor{1dd}@anchor{gnat_ugn/platform_specific_information
win32-calling-convention}@anchor{1de}
+@anchor{gnat_ugn/platform_specific_information
id19}@anchor{1de}@anchor{gnat_ugn/platform_specific_information
win32-calling-convention}@anchor{1df}
@subsubsection @code{Win32} Calling Convention
@@ -23701,7 +23723,7 @@ This convention, which is GNAT-specific is fully
equivalent to the
@code{Stdcall} calling convention described above.
@node DLL Calling Convention,,Win32 Calling Convention,Windows Calling
Conventions
-@anchor{gnat_ugn/platform_specific_information
dll-calling-convention}@anchor{1df}@anchor{gnat_ugn/platform_specific_information
id20}@anchor{1e0}
+@anchor{gnat_ugn/platform_specific_information
dll-calling-convention}@anchor{1e0}@anchor{gnat_ugn/platform_specific_information
id20}@anchor{1e1}
@subsubsection @code{DLL} Calling Convention
@@ -23709,7 +23731,7 @@ This convention, which is GNAT-specific is fully
equivalent to the
@code{Stdcall} calling convention described above.
@node Introduction to Dynamic Link Libraries DLLs,Using DLLs with GNAT,Windows
Calling Conventions,Mixed-Language Programming on Windows
-@anchor{gnat_ugn/platform_specific_information
id21}@anchor{1e1}@anchor{gnat_ugn/platform_specific_information
introduction-to-dynamic-link-libraries-dlls}@anchor{1e2}
+@anchor{gnat_ugn/platform_specific_information
id21}@anchor{1e2}@anchor{gnat_ugn/platform_specific_information
introduction-to-dynamic-link-libraries-dlls}@anchor{1e3}
@subsubsection Introduction to Dynamic Link Libraries (DLLs)
@@ -23793,10 +23815,10 @@ As a side note, an interesting difference between
Microsoft DLLs and
Unix shared libraries, is the fact that on most Unix systems all public
routines are exported by default in a Unix shared library, while under
Windows it is possible (but not required) to list exported routines in
-a definition file (see @ref{1e3,,The Definition File}).
+a definition file (see @ref{1e4,,The Definition File}).
@node Using DLLs with GNAT,Building DLLs with GNAT Project files,Introduction
to Dynamic Link Libraries DLLs,Mixed-Language Programming on Windows
-@anchor{gnat_ugn/platform_specific_information
id22}@anchor{1e4}@anchor{gnat_ugn/platform_specific_information
using-dlls-with-gnat}@anchor{1d5}
+@anchor{gnat_ugn/platform_specific_information
id22}@anchor{1e5}@anchor{gnat_ugn/platform_specific_information
using-dlls-with-gnat}@anchor{1d6}
@subsubsection Using DLLs with GNAT
@@ -23887,7 +23909,7 @@ example a fictitious DLL called @code{API.dll}.
@end menu
@node Creating an Ada Spec for the DLL Services,Creating an Import
Library,,Using DLLs with GNAT
-@anchor{gnat_ugn/platform_specific_information
creating-an-ada-spec-for-the-dll-services}@anchor{1e5}@anchor{gnat_ugn/platform_specific_information
id23}@anchor{1e6}
+@anchor{gnat_ugn/platform_specific_information
creating-an-ada-spec-for-the-dll-services}@anchor{1e6}@anchor{gnat_ugn/platform_specific_information
id23}@anchor{1e7}
@subsubsection Creating an Ada Spec for the DLL Services
@@ -23927,7 +23949,7 @@ end API;
@end quotation
@node Creating an Import Library,,Creating an Ada Spec for the DLL
Services,Using DLLs with GNAT
-@anchor{gnat_ugn/platform_specific_information
creating-an-import-library}@anchor{1e7}@anchor{gnat_ugn/platform_specific_information
id24}@anchor{1e8}
+@anchor{gnat_ugn/platform_specific_information
creating-an-import-library}@anchor{1e8}@anchor{gnat_ugn/platform_specific_information
id24}@anchor{1e9}
@subsubsection Creating an Import Library
@@ -23941,7 +23963,7 @@ as in this case it is possible to link directly against
the
DLL. Otherwise read on.
@geindex Definition file
-@anchor{gnat_ugn/platform_specific_information the-definition-file}@anchor{1e3}
+@anchor{gnat_ugn/platform_specific_information the-definition-file}@anchor{1e4}
@subsubheading The Definition File
@@ -23989,17 +24011,17 @@ EXPORTS
@end table
Note that you must specify the correct suffix (@code{@@@var{nn}})
-(see @ref{1d8,,Windows Calling Conventions}) for a Stdcall
+(see @ref{1d9,,Windows Calling Conventions}) for a Stdcall
calling convention function in the exported symbols list.
There can actually be other sections in a definition file, but these
sections are not relevant to the discussion at hand.
-@anchor{gnat_ugn/platform_specific_information
create-def-file-automatically}@anchor{1e9}
+@anchor{gnat_ugn/platform_specific_information
create-def-file-automatically}@anchor{1ea}
@subsubheading Creating a Definition File Automatically
You can automatically create the definition file @code{API.def}
-(see @ref{1e3,,The Definition File}) from a DLL.
+(see @ref{1e4,,The Definition File}) from a DLL.
For that use the @code{dlltool} program as follows:
@quotation
@@ -24009,7 +24031,7 @@ $ dlltool API.dll -z API.def --export-all-symbols
@end example
Note that if some routines in the DLL have the @code{Stdcall} convention
-(@ref{1d8,,Windows Calling Conventions}) with stripped @code{@@@var{nn}}
+(@ref{1d9,,Windows Calling Conventions}) with stripped @code{@@@var{nn}}
suffix then you’ll have to edit @code{api.def} to add it, and specify
@code{-k} to @code{gnatdll} when creating the import library.
@@ -24033,13 +24055,13 @@ tells you what symbol is expected. You just have to
go back to the
definition file and add the right suffix.
@end itemize
@end quotation
-@anchor{gnat_ugn/platform_specific_information
gnat-style-import-library}@anchor{1ea}
+@anchor{gnat_ugn/platform_specific_information
gnat-style-import-library}@anchor{1eb}
@subsubheading GNAT-Style Import Library
To create a static import library from @code{API.dll} with the GNAT tools
you should create the .def file, then use @code{gnatdll} tool
-(see @ref{1eb,,Using gnatdll}) as follows:
+(see @ref{1ec,,Using gnatdll}) as follows:
@quotation
@@ -24055,15 +24077,15 @@ definition file name is @code{xyz.def}, the import
library name will
be @code{libxyz.a}. Note that in the previous example option
@code{-e} could have been removed because the name of the definition
file (before the @code{.def} suffix) is the same as the name of the
-DLL (@ref{1eb,,Using gnatdll} for more information about @code{gnatdll}).
+DLL (@ref{1ec,,Using gnatdll} for more information about @code{gnatdll}).
@end quotation
-@anchor{gnat_ugn/platform_specific_information
msvs-style-import-library}@anchor{1ec}
+@anchor{gnat_ugn/platform_specific_information
msvs-style-import-library}@anchor{1ed}
@subsubheading Microsoft-Style Import Library
A Microsoft import library is needed only if you plan to make an
Ada DLL available to applications developed with Microsoft
-tools (@ref{1d4,,Mixed-Language Programming on Windows}).
+tools (@ref{1d5,,Mixed-Language Programming on Windows}).
To create a Microsoft-style import library for @code{API.dll} you
should create the .def file, then build the actual import library using
@@ -24087,7 +24109,7 @@ See the Microsoft documentation for further details
about the usage of
@end quotation
@node Building DLLs with GNAT Project files,Building DLLs with GNAT,Using DLLs
with GNAT,Mixed-Language Programming on Windows
-@anchor{gnat_ugn/platform_specific_information
building-dlls-with-gnat-project-files}@anchor{1d6}@anchor{gnat_ugn/platform_specific_information
id25}@anchor{1ed}
+@anchor{gnat_ugn/platform_specific_information
building-dlls-with-gnat-project-files}@anchor{1d7}@anchor{gnat_ugn/platform_specific_information
id25}@anchor{1ee}
@subsubsection Building DLLs with GNAT Project files
@@ -24103,7 +24125,7 @@ when inside the @code{DllMain} routine which is used
for auto-initialization
of shared libraries, so it is not possible to have library level tasks in SALs.
@node Building DLLs with GNAT,Building DLLs with gnatdll,Building DLLs with
GNAT Project files,Mixed-Language Programming on Windows
-@anchor{gnat_ugn/platform_specific_information
building-dlls-with-gnat}@anchor{1ee}@anchor{gnat_ugn/platform_specific_information
id26}@anchor{1ef}
+@anchor{gnat_ugn/platform_specific_information
building-dlls-with-gnat}@anchor{1ef}@anchor{gnat_ugn/platform_specific_information
id26}@anchor{1f0}
@subsubsection Building DLLs with GNAT
@@ -24134,7 +24156,7 @@ $ gcc -shared -shared-libgcc -o api.dll obj1.o obj2.o
...
It is important to note that in this case all symbols found in the
object files are automatically exported. It is possible to restrict
the set of symbols to export by passing to @code{gcc} a definition
-file (see @ref{1e3,,The Definition File}).
+file (see @ref{1e4,,The Definition File}).
For example:
@example
@@ -24172,7 +24194,7 @@ $ gnatmake main -Iapilib -bargs -shared -largs -Lapilib
-lAPI
@end quotation
@node Building DLLs with gnatdll,Ada DLLs and Finalization,Building DLLs with
GNAT,Mixed-Language Programming on Windows
-@anchor{gnat_ugn/platform_specific_information
building-dlls-with-gnatdll}@anchor{1f0}@anchor{gnat_ugn/platform_specific_information
id27}@anchor{1f1}
+@anchor{gnat_ugn/platform_specific_information
building-dlls-with-gnatdll}@anchor{1f1}@anchor{gnat_ugn/platform_specific_information
id27}@anchor{1f2}
@subsubsection Building DLLs with gnatdll
@@ -24180,8 +24202,8 @@ $ gnatmake main -Iapilib -bargs -shared -largs -Lapilib
-lAPI
@geindex building
Note that it is preferred to use GNAT Project files
-(@ref{1d6,,Building DLLs with GNAT Project files}) or the built-in GNAT
-DLL support (@ref{1ee,,Building DLLs with GNAT}) or to build DLLs.
+(@ref{1d7,,Building DLLs with GNAT Project files}) or the built-in GNAT
+DLL support (@ref{1ef,,Building DLLs with GNAT}) or to build DLLs.
This section explains how to build DLLs containing Ada code using
@code{gnatdll}. These DLLs will be referred to as Ada DLLs in the
@@ -24197,20 +24219,20 @@ non-Ada applications are as follows:
You need to mark each Ada entity exported by the DLL with a @code{C} or
@code{Stdcall} calling convention to avoid any Ada name mangling for the
entities exported by the DLL
-(see @ref{1f2,,Exporting Ada Entities}). You can
+(see @ref{1f3,,Exporting Ada Entities}). You can
skip this step if you plan to use the Ada DLL only from Ada applications.
@item
Your Ada code must export an initialization routine which calls the routine
@code{adainit} generated by @code{gnatbind} to perform the elaboration of
-the Ada code in the DLL (@ref{1f3,,Ada DLLs and Elaboration}). The
initialization
+the Ada code in the DLL (@ref{1f4,,Ada DLLs and Elaboration}). The
initialization
routine exported by the Ada DLL must be invoked by the clients of the DLL
to initialize the DLL.
@item
When useful, the DLL should also export a finalization routine which calls
routine @code{adafinal} generated by @code{gnatbind} to perform the
-finalization of the Ada code in the DLL (@ref{1f4,,Ada DLLs and Finalization}).
+finalization of the Ada code in the DLL (@ref{1f5,,Ada DLLs and Finalization}).
The finalization routine exported by the Ada DLL must be invoked by the
clients of the DLL when the DLL services are no further needed.
@@ -24220,11 +24242,11 @@ of the programming languages to which you plan to
make the DLL available.
@item
You must provide a definition file listing the exported entities
-(@ref{1e3,,The Definition File}).
+(@ref{1e4,,The Definition File}).
@item
Finally you must use @code{gnatdll} to produce the DLL and the import
-library (@ref{1eb,,Using gnatdll}).
+library (@ref{1ec,,Using gnatdll}).
@end itemize
Note that a relocatable DLL stripped using the @code{strip}
@@ -24244,7 +24266,7 @@ chapter of the `GPRbuild User’s Guide'.
@end menu
@node Limitations When Using Ada DLLs from Ada,Exporting Ada
Entities,,Building DLLs with gnatdll
-@anchor{gnat_ugn/platform_specific_information
limitations-when-using-ada-dlls-from-ada}@anchor{1f5}
+@anchor{gnat_ugn/platform_specific_information
limitations-when-using-ada-dlls-from-ada}@anchor{1f6}
@subsubsection Limitations When Using Ada DLLs from Ada
@@ -24265,7 +24287,7 @@ It is completely safe to exchange plain elementary,
array or record types,
Windows object handles, etc.
@node Exporting Ada Entities,Ada DLLs and Elaboration,Limitations When Using
Ada DLLs from Ada,Building DLLs with gnatdll
-@anchor{gnat_ugn/platform_specific_information
exporting-ada-entities}@anchor{1f2}@anchor{gnat_ugn/platform_specific_information
id28}@anchor{1f6}
+@anchor{gnat_ugn/platform_specific_information
exporting-ada-entities}@anchor{1f3}@anchor{gnat_ugn/platform_specific_information
id28}@anchor{1f7}
@subsubsection Exporting Ada Entities
@@ -24365,10 +24387,10 @@ end API;
Note that if you do not export the Ada entities with a @code{C} or
@code{Stdcall} convention you will have to provide the mangled Ada names
in the definition file of the Ada DLL
-(@ref{1f7,,Creating the Definition File}).
+(@ref{1f8,,Creating the Definition File}).
@node Ada DLLs and Elaboration,,Exporting Ada Entities,Building DLLs with
gnatdll
-@anchor{gnat_ugn/platform_specific_information
ada-dlls-and-elaboration}@anchor{1f3}@anchor{gnat_ugn/platform_specific_information
id29}@anchor{1f8}
+@anchor{gnat_ugn/platform_specific_information
ada-dlls-and-elaboration}@anchor{1f4}@anchor{gnat_ugn/platform_specific_information
id29}@anchor{1f9}
@subsubsection Ada DLLs and Elaboration
@@ -24386,7 +24408,7 @@ the Ada elaboration routine @code{adainit} generated by
the GNAT binder
(@ref{7e,,Binding with Non-Ada Main Programs}). See the body of
@code{Initialize_Api} for an example. Note that the GNAT binder is
automatically invoked during the DLL build process by the @code{gnatdll}
-tool (@ref{1eb,,Using gnatdll}).
+tool (@ref{1ec,,Using gnatdll}).
When a DLL is loaded, Windows systematically invokes a routine called
@code{DllMain}. It would therefore be possible to call @code{adainit}
@@ -24399,7 +24421,7 @@ time), which means that the GNAT run-time will deadlock
waiting for the
newly created task to complete its initialization.
@node Ada DLLs and Finalization,Creating a Spec for Ada DLLs,Building DLLs
with gnatdll,Mixed-Language Programming on Windows
-@anchor{gnat_ugn/platform_specific_information
ada-dlls-and-finalization}@anchor{1f4}@anchor{gnat_ugn/platform_specific_information
id30}@anchor{1f9}
+@anchor{gnat_ugn/platform_specific_information
ada-dlls-and-finalization}@anchor{1f5}@anchor{gnat_ugn/platform_specific_information
id30}@anchor{1fa}
@subsubsection Ada DLLs and Finalization
@@ -24414,10 +24436,10 @@ routine @code{adafinal} generated by the GNAT binder
See the body of @code{Finalize_Api} for an
example. As already pointed out the GNAT binder is automatically invoked
during the DLL build process by the @code{gnatdll} tool
-(@ref{1eb,,Using gnatdll}).
+(@ref{1ec,,Using gnatdll}).
@node Creating a Spec for Ada DLLs,GNAT and Windows Resources,Ada DLLs and
Finalization,Mixed-Language Programming on Windows
-@anchor{gnat_ugn/platform_specific_information
creating-a-spec-for-ada-dlls}@anchor{1fa}@anchor{gnat_ugn/platform_specific_information
id31}@anchor{1fb}
+@anchor{gnat_ugn/platform_specific_information
creating-a-spec-for-ada-dlls}@anchor{1fb}@anchor{gnat_ugn/platform_specific_information
id31}@anchor{1fc}
@subsubsection Creating a Spec for Ada DLLs
@@ -24475,7 +24497,7 @@ end API;
@end menu
@node Creating the Definition File,Using gnatdll,,Creating a Spec for Ada DLLs
-@anchor{gnat_ugn/platform_specific_information
creating-the-definition-file}@anchor{1f7}@anchor{gnat_ugn/platform_specific_information
id32}@anchor{1fc}
+@anchor{gnat_ugn/platform_specific_information
creating-the-definition-file}@anchor{1f8}@anchor{gnat_ugn/platform_specific_information
id32}@anchor{1fd}
@subsubsection Creating the Definition File
@@ -24511,7 +24533,7 @@ EXPORTS
@end quotation
@node Using gnatdll,,Creating the Definition File,Creating a Spec for Ada DLLs
-@anchor{gnat_ugn/platform_specific_information
id33}@anchor{1fd}@anchor{gnat_ugn/platform_specific_information
using-gnatdll}@anchor{1eb}
+@anchor{gnat_ugn/platform_specific_information
id33}@anchor{1fe}@anchor{gnat_ugn/platform_specific_information
using-gnatdll}@anchor{1ec}
@subsubsection Using @code{gnatdll}
@@ -24722,7 +24744,7 @@ asks @code{gnatlink} to generate the routines
@code{DllMain} and
is loaded into memory.
@item
-@code{gnatdll} uses @code{dlltool} (see @ref{1fe,,Using dlltool}) to build the
+@code{gnatdll} uses @code{dlltool} (see @ref{1ff,,Using dlltool}) to build the
export table (@code{api.exp}). The export table contains the relocation
information in a form which can be used during the final link to ensure
that the Windows loader is able to place the DLL anywhere in memory.
@@ -24761,7 +24783,7 @@ $ gnatbind -n api
$ gnatlink api api.exp -o api.dll -mdll
@end example
@end itemize
-@anchor{gnat_ugn/platform_specific_information using-dlltool}@anchor{1fe}
+@anchor{gnat_ugn/platform_specific_information using-dlltool}@anchor{1ff}
@subsubheading Using @code{dlltool}
@@ -24820,7 +24842,7 @@ DLL in the static import library generated by
@code{dlltool} with switch
@item @code{-k}
Kill @code{@@@var{nn}} from exported names
-(@ref{1d8,,Windows Calling Conventions}
+(@ref{1d9,,Windows Calling Conventions}
for a discussion about @code{Stdcall}-style symbols).
@end table
@@ -24876,7 +24898,7 @@ Use @code{assembler-name} as the assembler. The default
is @code{as}.
@end table
@node GNAT and Windows Resources,Using GNAT DLLs from Microsoft Visual Studio
Applications,Creating a Spec for Ada DLLs,Mixed-Language Programming on Windows
-@anchor{gnat_ugn/platform_specific_information
gnat-and-windows-resources}@anchor{1ff}@anchor{gnat_ugn/platform_specific_information
id34}@anchor{200}
+@anchor{gnat_ugn/platform_specific_information
gnat-and-windows-resources}@anchor{200}@anchor{gnat_ugn/platform_specific_information
id34}@anchor{201}
@subsubsection GNAT and Windows Resources
@@ -24971,7 +24993,7 @@ the corresponding Microsoft documentation.
@end menu
@node Building Resources,Compiling Resources,,GNAT and Windows Resources
-@anchor{gnat_ugn/platform_specific_information
building-resources}@anchor{201}@anchor{gnat_ugn/platform_specific_information
id35}@anchor{202}
+@anchor{gnat_ugn/platform_specific_information
building-resources}@anchor{202}@anchor{gnat_ugn/platform_specific_information
id35}@anchor{203}
@subsubsection Building Resources
@@ -24991,7 +25013,7 @@ complete description of the resource script language
can be found in the
Microsoft documentation.
@node Compiling Resources,Using Resources,Building Resources,GNAT and Windows
Resources
-@anchor{gnat_ugn/platform_specific_information
compiling-resources}@anchor{203}@anchor{gnat_ugn/platform_specific_information
id36}@anchor{204}
+@anchor{gnat_ugn/platform_specific_information
compiling-resources}@anchor{204}@anchor{gnat_ugn/platform_specific_information
id36}@anchor{205}
@subsubsection Compiling Resources
@@ -25033,7 +25055,7 @@ $ windres -i myres.res -o myres.o
@end quotation
@node Using Resources,,Compiling Resources,GNAT and Windows Resources
-@anchor{gnat_ugn/platform_specific_information
id37}@anchor{205}@anchor{gnat_ugn/platform_specific_information
using-resources}@anchor{206}
+@anchor{gnat_ugn/platform_specific_information
id37}@anchor{206}@anchor{gnat_ugn/platform_specific_information
using-resources}@anchor{207}
@subsubsection Using Resources
@@ -25053,7 +25075,7 @@ $ gnatmake myprog -largs myres.o
@end quotation
@node Using GNAT DLLs from Microsoft Visual Studio Applications,Debugging a
DLL,GNAT and Windows Resources,Mixed-Language Programming on Windows
-@anchor{gnat_ugn/platform_specific_information
using-gnat-dll-from-msvs}@anchor{207}@anchor{gnat_ugn/platform_specific_information
using-gnat-dlls-from-microsoft-visual-studio-applications}@anchor{208}
+@anchor{gnat_ugn/platform_specific_information
using-gnat-dll-from-msvs}@anchor{208}@anchor{gnat_ugn/platform_specific_information
using-gnat-dlls-from-microsoft-visual-studio-applications}@anchor{209}
@subsubsection Using GNAT DLLs from Microsoft Visual Studio Applications
@@ -25087,7 +25109,7 @@ $ gprbuild -p mylib.gpr
@item
Produce a .def file for the symbols you need to interface with, either by
hand or automatically with possibly some manual adjustments
-(see @ref{1e9,,Creating Definition File Automatically}):
+(see @ref{1ea,,Creating Definition File Automatically}):
@end enumerate
@quotation
@@ -25104,7 +25126,7 @@ $ dlltool libmylib.dll -z libmylib.def
--export-all-symbols
Make sure that MSVS command-line tools are accessible on the path.
@item
-Create the Microsoft-style import library (see @ref{1ec,,MSVS-Style Import
Library}):
+Create the Microsoft-style import library (see @ref{1ed,,MSVS-Style Import
Library}):
@end enumerate
@quotation
@@ -25146,7 +25168,7 @@ or copy the DLL into into the directory containing the
.exe.
@end enumerate
@node Debugging a DLL,Setting Stack Size from gnatlink,Using GNAT DLLs from
Microsoft Visual Studio Applications,Mixed-Language Programming on Windows
-@anchor{gnat_ugn/platform_specific_information
debugging-a-dll}@anchor{209}@anchor{gnat_ugn/platform_specific_information
id38}@anchor{20a}
+@anchor{gnat_ugn/platform_specific_information
debugging-a-dll}@anchor{20a}@anchor{gnat_ugn/platform_specific_information
id38}@anchor{20b}
@subsubsection Debugging a DLL
@@ -25184,7 +25206,7 @@ tools suite used to build the DLL.
@end menu
@node Program and DLL Both Built with GCC/GNAT,Program Built with Foreign
Tools and DLL Built with GCC/GNAT,,Debugging a DLL
-@anchor{gnat_ugn/platform_specific_information
id39}@anchor{20b}@anchor{gnat_ugn/platform_specific_information
program-and-dll-both-built-with-gcc-gnat}@anchor{20c}
+@anchor{gnat_ugn/platform_specific_information
id39}@anchor{20c}@anchor{gnat_ugn/platform_specific_information
program-and-dll-both-built-with-gcc-gnat}@anchor{20d}
@subsubsection Program and DLL Both Built with GCC/GNAT
@@ -25194,7 +25216,7 @@ the process. Let’s suppose here that the main procedure
is named
@code{ada_main} and that in the DLL there is an entry point named
@code{ada_dll}.
-The DLL (@ref{1e2,,Introduction to Dynamic Link Libraries (DLLs)}) and
+The DLL (@ref{1e3,,Introduction to Dynamic Link Libraries (DLLs)}) and
program must have been built with the debugging information (see GNAT -g
switch). Here are the step-by-step instructions for debugging it:
@@ -25231,10 +25253,10 @@ Set a breakpoint inside the DLL
At this stage a breakpoint is set inside the DLL. From there on
you can use the standard approach to debug the whole program
-(@ref{14f,,Running and Debugging Ada Programs}).
+(@ref{150,,Running and Debugging Ada Programs}).
@node Program Built with Foreign Tools and DLL Built with GCC/GNAT,,Program
and DLL Both Built with GCC/GNAT,Debugging a DLL
-@anchor{gnat_ugn/platform_specific_information
id40}@anchor{20d}@anchor{gnat_ugn/platform_specific_information
program-built-with-foreign-tools-and-dll-built-with-gcc-gnat}@anchor{20e}
+@anchor{gnat_ugn/platform_specific_information
id40}@anchor{20e}@anchor{gnat_ugn/platform_specific_information
program-built-with-foreign-tools-and-dll-built-with-gcc-gnat}@anchor{20f}
@subsubsection Program Built with Foreign Tools and DLL Built with GCC/GNAT
@@ -25251,7 +25273,7 @@ example some C code built with Microsoft Visual C) and
that there is a
DLL named @code{test.dll} containing an Ada entry point named
@code{ada_dll}.
-The DLL (see @ref{1e2,,Introduction to Dynamic Link Libraries (DLLs)}) must
have
+The DLL (see @ref{1e3,,Introduction to Dynamic Link Libraries (DLLs)}) must
have
been built with debugging information (see the GNAT @code{-g} option).
@subsubheading Debugging the DLL Directly
@@ -25317,7 +25339,7 @@ Continue the program.
This will run the program until it reaches the breakpoint that has been
set. From that point you can use the standard way to debug a program
-as described in (@ref{14f,,Running and Debugging Ada Programs}).
+as described in (@ref{150,,Running and Debugging Ada Programs}).
@end itemize
It is also possible to debug the DLL by attaching to a running process.
@@ -25387,10 +25409,10 @@ Continue process execution.
This last step will resume the process execution, and stop at
the breakpoint we have set. From there you can use the standard
approach to debug a program as described in
-@ref{14f,,Running and Debugging Ada Programs}.
+@ref{150,,Running and Debugging Ada Programs}.
@node Setting Stack Size from gnatlink,Setting Heap Size from
gnatlink,Debugging a DLL,Mixed-Language Programming on Windows
-@anchor{gnat_ugn/platform_specific_information
id41}@anchor{20f}@anchor{gnat_ugn/platform_specific_information
setting-stack-size-from-gnatlink}@anchor{129}
+@anchor{gnat_ugn/platform_specific_information
id41}@anchor{210}@anchor{gnat_ugn/platform_specific_information
setting-stack-size-from-gnatlink}@anchor{12a}
@subsubsection Setting Stack Size from @code{gnatlink}
@@ -25433,7 +25455,7 @@ because the comma is a separator for this option.
@end itemize
@node Setting Heap Size from gnatlink,,Setting Stack Size from
gnatlink,Mixed-Language Programming on Windows
-@anchor{gnat_ugn/platform_specific_information
id42}@anchor{210}@anchor{gnat_ugn/platform_specific_information
setting-heap-size-from-gnatlink}@anchor{12a}
+@anchor{gnat_ugn/platform_specific_information
id42}@anchor{211}@anchor{gnat_ugn/platform_specific_information
setting-heap-size-from-gnatlink}@anchor{12b}
@subsubsection Setting Heap Size from @code{gnatlink}
@@ -25466,7 +25488,7 @@ because the comma is a separator for this option.
@end itemize
@node Windows Specific Add-Ons,,Mixed-Language Programming on
Windows,Microsoft Windows Topics
-@anchor{gnat_ugn/platform_specific_information
win32-specific-addons}@anchor{211}@anchor{gnat_ugn/platform_specific_information
windows-specific-add-ons}@anchor{212}
+@anchor{gnat_ugn/platform_specific_information
win32-specific-addons}@anchor{212}@anchor{gnat_ugn/platform_specific_information
windows-specific-add-ons}@anchor{213}
@subsection Windows Specific Add-Ons
@@ -25479,7 +25501,7 @@ This section describes the Windows specific add-ons.
@end menu
@node Win32Ada,wPOSIX,,Windows Specific Add-Ons
-@anchor{gnat_ugn/platform_specific_information
id43}@anchor{213}@anchor{gnat_ugn/platform_specific_information
win32ada}@anchor{214}
+@anchor{gnat_ugn/platform_specific_information
id43}@anchor{214}@anchor{gnat_ugn/platform_specific_information
win32ada}@anchor{215}
@subsubsection Win32Ada
@@ -25510,7 +25532,7 @@ gprbuild p.gpr
@end quotation
@node wPOSIX,,Win32Ada,Windows Specific Add-Ons
-@anchor{gnat_ugn/platform_specific_information
id44}@anchor{215}@anchor{gnat_ugn/platform_specific_information
wposix}@anchor{216}
+@anchor{gnat_ugn/platform_specific_information
id44}@anchor{216}@anchor{gnat_ugn/platform_specific_information
wposix}@anchor{217}
@subsubsection wPOSIX
@@ -25543,7 +25565,7 @@ gprbuild p.gpr
@end quotation
@node Mac OS Topics,,Microsoft Windows Topics,Platform-Specific Information
-@anchor{gnat_ugn/platform_specific_information
id45}@anchor{217}@anchor{gnat_ugn/platform_specific_information
mac-os-topics}@anchor{218}
+@anchor{gnat_ugn/platform_specific_information
id45}@anchor{218}@anchor{gnat_ugn/platform_specific_information
mac-os-topics}@anchor{219}
@section Mac OS Topics
@@ -25558,7 +25580,7 @@ platform.
@end menu
@node Codesigning the Debugger,,,Mac OS Topics
-@anchor{gnat_ugn/platform_specific_information
codesigning-the-debugger}@anchor{219}
+@anchor{gnat_ugn/platform_specific_information
codesigning-the-debugger}@anchor{21a}
@subsection Codesigning the Debugger
@@ -25639,7 +25661,7 @@ the location where you installed GNAT. Also, be sure
that users are
in the Unix group @code{_developer}.
@node Example of Binder Output File,Elaboration Order Handling in
GNAT,Platform-Specific Information,Top
-@anchor{gnat_ugn/example_of_binder_output
doc}@anchor{21a}@anchor{gnat_ugn/example_of_binder_output
example-of-binder-output-file}@anchor{e}@anchor{gnat_ugn/example_of_binder_output
id1}@anchor{21b}
+@anchor{gnat_ugn/example_of_binder_output
doc}@anchor{21b}@anchor{gnat_ugn/example_of_binder_output
example-of-binder-output-file}@anchor{e}@anchor{gnat_ugn/example_of_binder_output
id1}@anchor{21c}
@chapter Example of Binder Output File
@@ -26391,7 +26413,7 @@ elaboration code in your own application).
@c -- Example: A |withing| unit has a |with| clause, it |withs| a |withed| unit
@node Elaboration Order Handling in GNAT,Inline Assembler,Example of Binder
Output File,Top
-@anchor{gnat_ugn/elaboration_order_handling_in_gnat
doc}@anchor{21c}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
elaboration-order-handling-in-gnat}@anchor{f}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id1}@anchor{21d}
+@anchor{gnat_ugn/elaboration_order_handling_in_gnat
doc}@anchor{21d}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
elaboration-order-handling-in-gnat}@anchor{f}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id1}@anchor{21e}
@chapter Elaboration Order Handling in GNAT
@@ -26421,7 +26443,7 @@ GNAT, either automatically or with explicit programming
features.
@end menu
@node Elaboration Code,Elaboration Order,,Elaboration Order Handling in GNAT
-@anchor{gnat_ugn/elaboration_order_handling_in_gnat
elaboration-code}@anchor{21e}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id2}@anchor{21f}
+@anchor{gnat_ugn/elaboration_order_handling_in_gnat
elaboration-code}@anchor{21f}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id2}@anchor{220}
@section Elaboration Code
@@ -26569,7 +26591,7 @@ elaborated.
@end itemize
@node Elaboration Order,Checking the Elaboration Order,Elaboration
Code,Elaboration Order Handling in GNAT
-@anchor{gnat_ugn/elaboration_order_handling_in_gnat
elaboration-order}@anchor{220}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id3}@anchor{221}
+@anchor{gnat_ugn/elaboration_order_handling_in_gnat
elaboration-order}@anchor{221}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id3}@anchor{222}
@section Elaboration Order
@@ -26738,7 +26760,7 @@ however a compiler may not always find such an order
due to complications with
respect to control and data flow.
@node Checking the Elaboration Order,Controlling the Elaboration Order in
Ada,Elaboration Order,Elaboration Order Handling in GNAT
-@anchor{gnat_ugn/elaboration_order_handling_in_gnat
checking-the-elaboration-order}@anchor{222}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id4}@anchor{223}
+@anchor{gnat_ugn/elaboration_order_handling_in_gnat
checking-the-elaboration-order}@anchor{223}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id4}@anchor{224}
@section Checking the Elaboration Order
@@ -26799,7 +26821,7 @@ order.
@end itemize
@node Controlling the Elaboration Order in Ada,Controlling the Elaboration
Order in GNAT,Checking the Elaboration Order,Elaboration Order Handling in GNAT
-@anchor{gnat_ugn/elaboration_order_handling_in_gnat
controlling-the-elaboration-order-in-ada}@anchor{224}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id5}@anchor{225}
+@anchor{gnat_ugn/elaboration_order_handling_in_gnat
controlling-the-elaboration-order-in-ada}@anchor{225}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id5}@anchor{226}
@section Controlling the Elaboration Order in Ada
@@ -27127,7 +27149,7 @@ is that the program continues to stay in the last state
(one or more correct
orders exist) even if maintenance changes the bodies of targets.
@node Controlling the Elaboration Order in GNAT,Mixing Elaboration
Models,Controlling the Elaboration Order in Ada,Elaboration Order Handling in
GNAT
-@anchor{gnat_ugn/elaboration_order_handling_in_gnat
controlling-the-elaboration-order-in-gnat}@anchor{226}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id6}@anchor{227}
+@anchor{gnat_ugn/elaboration_order_handling_in_gnat
controlling-the-elaboration-order-in-gnat}@anchor{227}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id6}@anchor{228}
@section Controlling the Elaboration Order in GNAT
@@ -27257,7 +27279,7 @@ The dynamic, legacy, and static models can be relaxed
using compiler switch
may not diagnose certain elaboration issues or install run-time checks.
@node Mixing Elaboration Models,ABE Diagnostics,Controlling the Elaboration
Order in GNAT,Elaboration Order Handling in GNAT
-@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id7}@anchor{228}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
mixing-elaboration-models}@anchor{229}
+@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id7}@anchor{229}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
mixing-elaboration-models}@anchor{22a}
@section Mixing Elaboration Models
@@ -27304,7 +27326,7 @@ warning: "y.ads" which has static elaboration checks
The warnings can be suppressed by binder switch @code{-ws}.
@node ABE Diagnostics,SPARK Diagnostics,Mixing Elaboration Models,Elaboration
Order Handling in GNAT
-@anchor{gnat_ugn/elaboration_order_handling_in_gnat
abe-diagnostics}@anchor{22a}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id8}@anchor{22b}
+@anchor{gnat_ugn/elaboration_order_handling_in_gnat
abe-diagnostics}@anchor{22b}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id8}@anchor{22c}
@section ABE Diagnostics
@@ -27411,7 +27433,7 @@ declaration @code{Safe} because the body of function
@code{ABE} has already been
elaborated at that point.
@node SPARK Diagnostics,Elaboration Circularities,ABE Diagnostics,Elaboration
Order Handling in GNAT
-@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id9}@anchor{22c}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
spark-diagnostics}@anchor{22d}
+@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id9}@anchor{22d}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
spark-diagnostics}@anchor{22e}
@section SPARK Diagnostics
@@ -27437,7 +27459,7 @@ rules.
@end quotation
@node Elaboration Circularities,Resolving Elaboration Circularities,SPARK
Diagnostics,Elaboration Order Handling in GNAT
-@anchor{gnat_ugn/elaboration_order_handling_in_gnat
elaboration-circularities}@anchor{22e}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id10}@anchor{22f}
+@anchor{gnat_ugn/elaboration_order_handling_in_gnat
elaboration-circularities}@anchor{22f}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id10}@anchor{230}
@section Elaboration Circularities
@@ -27537,7 +27559,7 @@ This section enumerates various tactics for eliminating
the circularity.
@end itemize
@node Resolving Elaboration Circularities,Elaboration-related Compiler
Switches,Elaboration Circularities,Elaboration Order Handling in GNAT
-@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id11}@anchor{230}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
resolving-elaboration-circularities}@anchor{231}
+@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id11}@anchor{231}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
resolving-elaboration-circularities}@anchor{232}
@section Resolving Elaboration Circularities
@@ -27809,7 +27831,7 @@ Use the relaxed dynamic-elaboration model, with
compiler switches
@end itemize
@node Elaboration-related Compiler Switches,Summary of Procedures for
Elaboration Control,Resolving Elaboration Circularities,Elaboration Order
Handling in GNAT
-@anchor{gnat_ugn/elaboration_order_handling_in_gnat
elaboration-related-compiler-switches}@anchor{232}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id12}@anchor{233}
+@anchor{gnat_ugn/elaboration_order_handling_in_gnat
elaboration-related-compiler-switches}@anchor{233}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id12}@anchor{234}
@section Elaboration-related Compiler Switches
@@ -27990,7 +28012,7 @@ checks. The example above will still fail at run time
with an ABE.
@end table
@node Summary of Procedures for Elaboration Control,Inspecting the Chosen
Elaboration Order,Elaboration-related Compiler Switches,Elaboration Order
Handling in GNAT
-@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id13}@anchor{234}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
summary-of-procedures-for-elaboration-control}@anchor{235}
+@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id13}@anchor{235}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
summary-of-procedures-for-elaboration-control}@anchor{236}
@section Summary of Procedures for Elaboration Control
@@ -28048,7 +28070,7 @@ Use the relaxed dynamic elaboration model, with
compiler switches
@end itemize
@node Inspecting the Chosen Elaboration Order,,Summary of Procedures for
Elaboration Control,Elaboration Order Handling in GNAT
-@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id14}@anchor{236}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
inspecting-the-chosen-elaboration-order}@anchor{237}
+@anchor{gnat_ugn/elaboration_order_handling_in_gnat
id14}@anchor{237}@anchor{gnat_ugn/elaboration_order_handling_in_gnat
inspecting-the-chosen-elaboration-order}@anchor{238}
@section Inspecting the Chosen Elaboration Order
@@ -28191,7 +28213,7 @@ gdbstr (body)
@end quotation
@node Inline Assembler,GNU Free Documentation License,Elaboration Order
Handling in GNAT,Top
-@anchor{gnat_ugn/inline_assembler
doc}@anchor{238}@anchor{gnat_ugn/inline_assembler
id1}@anchor{239}@anchor{gnat_ugn/inline_assembler inline-assembler}@anchor{10}
+@anchor{gnat_ugn/inline_assembler
doc}@anchor{239}@anchor{gnat_ugn/inline_assembler
id1}@anchor{23a}@anchor{gnat_ugn/inline_assembler inline-assembler}@anchor{10}
@chapter Inline Assembler
@@ -28250,7 +28272,7 @@ and with assembly language programming.
@end menu
@node Basic Assembler Syntax,A Simple Example of Inline Assembler,,Inline
Assembler
-@anchor{gnat_ugn/inline_assembler
basic-assembler-syntax}@anchor{23a}@anchor{gnat_ugn/inline_assembler
id2}@anchor{23b}
+@anchor{gnat_ugn/inline_assembler
basic-assembler-syntax}@anchor{23b}@anchor{gnat_ugn/inline_assembler
id2}@anchor{23c}
@section Basic Assembler Syntax
@@ -28366,7 +28388,7 @@ Intel: Destination first; for example @code{mov eax,
4}@w{ }
@node A Simple Example of Inline Assembler,Output Variables in Inline
Assembler,Basic Assembler Syntax,Inline Assembler
-@anchor{gnat_ugn/inline_assembler
a-simple-example-of-inline-assembler}@anchor{23c}@anchor{gnat_ugn/inline_assembler
id3}@anchor{23d}
+@anchor{gnat_ugn/inline_assembler
a-simple-example-of-inline-assembler}@anchor{23d}@anchor{gnat_ugn/inline_assembler
id3}@anchor{23e}
@section A Simple Example of Inline Assembler
@@ -28515,7 +28537,7 @@ If there are no errors, @code{as} will generate an
object file
@code{nothing.out}.
@node Output Variables in Inline Assembler,Input Variables in Inline
Assembler,A Simple Example of Inline Assembler,Inline Assembler
-@anchor{gnat_ugn/inline_assembler
id4}@anchor{23e}@anchor{gnat_ugn/inline_assembler
output-variables-in-inline-assembler}@anchor{23f}
+@anchor{gnat_ugn/inline_assembler
id4}@anchor{23f}@anchor{gnat_ugn/inline_assembler
output-variables-in-inline-assembler}@anchor{240}
@section Output Variables in Inline Assembler
@@ -28882,7 +28904,7 @@ end Get_Flags_3;
@end quotation
@node Input Variables in Inline Assembler,Inlining Inline Assembler
Code,Output Variables in Inline Assembler,Inline Assembler
-@anchor{gnat_ugn/inline_assembler
id5}@anchor{240}@anchor{gnat_ugn/inline_assembler
input-variables-in-inline-assembler}@anchor{241}
+@anchor{gnat_ugn/inline_assembler
id5}@anchor{241}@anchor{gnat_ugn/inline_assembler
input-variables-in-inline-assembler}@anchor{242}
@section Input Variables in Inline Assembler
@@ -28971,7 +28993,7 @@ _increment__incr.1:
@end quotation
@node Inlining Inline Assembler Code,Other Asm Functionality,Input Variables
in Inline Assembler,Inline Assembler
-@anchor{gnat_ugn/inline_assembler
id6}@anchor{242}@anchor{gnat_ugn/inline_assembler
inlining-inline-assembler-code}@anchor{243}
+@anchor{gnat_ugn/inline_assembler
id6}@anchor{243}@anchor{gnat_ugn/inline_assembler
inlining-inline-assembler-code}@anchor{244}
@section Inlining Inline Assembler Code
@@ -29042,7 +29064,7 @@ movl %esi,%eax
thus saving the overhead of stack frame setup and an out-of-line call.
@node Other Asm Functionality,,Inlining Inline Assembler Code,Inline Assembler
-@anchor{gnat_ugn/inline_assembler
id7}@anchor{244}@anchor{gnat_ugn/inline_assembler
other-asm-functionality}@anchor{245}
+@anchor{gnat_ugn/inline_assembler
id7}@anchor{245}@anchor{gnat_ugn/inline_assembler
other-asm-functionality}@anchor{246}
@section Other @code{Asm} Functionality
@@ -29057,7 +29079,7 @@ and @code{Volatile}, which inhibits unwanted
optimizations.
@end menu
@node The Clobber Parameter,The Volatile Parameter,,Other Asm Functionality
-@anchor{gnat_ugn/inline_assembler
id8}@anchor{246}@anchor{gnat_ugn/inline_assembler
the-clobber-parameter}@anchor{247}
+@anchor{gnat_ugn/inline_assembler
id8}@anchor{247}@anchor{gnat_ugn/inline_assembler
the-clobber-parameter}@anchor{248}
@subsection The @code{Clobber} Parameter
@@ -29121,7 +29143,7 @@ Use ‘register’ name @code{memory} if you changed a
memory location
@end itemize
@node The Volatile Parameter,,The Clobber Parameter,Other Asm Functionality
-@anchor{gnat_ugn/inline_assembler
id9}@anchor{248}@anchor{gnat_ugn/inline_assembler
the-volatile-parameter}@anchor{249}
+@anchor{gnat_ugn/inline_assembler
id9}@anchor{249}@anchor{gnat_ugn/inline_assembler
the-volatile-parameter}@anchor{24a}
@subsection The @code{Volatile} Parameter
@@ -29157,7 +29179,7 @@ to @code{True} only if the compiler’s optimizations
have created
problems.
@node GNU Free Documentation License,Index,Inline Assembler,Top
-@anchor{share/gnu_free_documentation_license
doc}@anchor{24a}@anchor{share/gnu_free_documentation_license
gnu-fdl}@anchor{1}@anchor{share/gnu_free_documentation_license
gnu-free-documentation-license}@anchor{24b}
+@anchor{share/gnu_free_documentation_license
doc}@anchor{24b}@anchor{share/gnu_free_documentation_license
gnu-fdl}@anchor{1}@anchor{share/gnu_free_documentation_license
gnu-free-documentation-license}@anchor{24c}
@chapter GNU Free Documentation License
@@ -29645,8 +29667,8 @@ to permit their use in free software.
@printindex ge
-@anchor{d1}@w{ }
@anchor{gnat_ugn/gnat_utility_programs switches-related-to-project-files}@w{
}
+@anchor{d1}@w{ }
@c %**end of body
@bye
diff --git a/gcc/ada/opt.ads b/gcc/ada/opt.ads
index d24b9b941ff..ce0caf48168 100644
--- a/gcc/ada/opt.ads
+++ b/gcc/ada/opt.ads
@@ -1667,6 +1667,11 @@ package Opt is
-- which requires pragma Warnings to be stored for the formal verification
-- backend.
+ Info_Suppressed : Boolean := False;
+ -- GNAT
+ -- Controls whether informational messages are suppressed. Set True by
+ -- -gnatis. If True, informational messages will not be printed.
+
Wide_Character_Encoding_Method : WC_Encoding_Method := WCEM_Brackets;
-- GNAT, GNATBIND
-- Method used for encoding wide characters in the source program. See
diff --git a/gcc/ada/switch-c.adb b/gcc/ada/switch-c.adb
index 43b69f1dde1..25cb6f20da6 100644
--- a/gcc/ada/switch-c.adb
+++ b/gcc/ada/switch-c.adb
@@ -927,7 +927,8 @@ package body Switch.C is
Ptr := Ptr + 1;
Legacy_Elaboration_Checks := True;
- -- -gnati (character set)
+ -- -gnati[1-5|8|9|p|f|n|w] (character set)
+ -- -gnatis (suppress info messages)
when 'i' =>
if Ptr = Max then
@@ -940,6 +941,9 @@ package body Switch.C is
if C in '1' .. '5' | '8' | 'p' | '9' | 'f' | 'n' | 'w' then
Identifier_Character_Set := C;
Ptr := Ptr + 1;
+ elsif C = 's' then
+ Info_Suppressed := True;
+ Ptr := Ptr + 1;
else
Bad_Switch ("-gnati" & Switch_Chars (Ptr .. Max));
--
2.45.1
