Skip to content

R
riscv-gcc-1
Commit 5a3c20f8 by Arnaud Charlet Committed by Pierre-Marie de Rodat
Options

[Ada] Remove references to gcov from the User Manual 

2018-07-17  Arnaud Charlet  <charlet@adacore.com>

gcc/ada/

	* doc/gnat_ugn/about_this_guide.rst,
	doc/gnat_ugn/gnat_and_program_execution.rst: Remove references to gcov.
	* gnat_ugn.texi: Regenerate.

From-SVN: r262765
parent a2cf456a
Showing with 202 additions and 400 deletions
gcc/ada/ChangeLog
2018-07-17 Arnaud Charlet <charlet@adacore.com>
* doc/gnat_ugn/about_this_guide.rst,
doc/gnat_ugn/gnat_and_program_execution.rst: Remove references to gcov.
* gnat_ugn.texi: Regenerate.
2018-07-16 Hristian Kirtchev <kirtchev@adacore.com> 2018-07-16 Hristian Kirtchev <kirtchev@adacore.com>
* contracts.adb (Analyze_Contracts): Add specialized processing for * contracts.adb (Analyze_Contracts): Add specialized processing for
......
gcc/ada/doc/gnat_ugn/about_this_guide.rst
...@@ -160,7 +160,7 @@ the new document structure. ...@@ -160,7 +160,7 @@ the new document structure.
* :ref:`GNAT_and_Program_Execution` is a new chapter consolidating the following: * :ref:`GNAT_and_Program_Execution` is a new chapter consolidating the following:
- :ref:`Running_and_Debugging_Ada_Programs` - :ref:`Running_and_Debugging_Ada_Programs`
- :ref:`Code_Coverage_and_Profiling` - :ref:`Profiling`
- :ref:`Improving_Performance` - :ref:`Improving_Performance`
- :ref:`Overflow Check Handling in GNAT <Overflow_Check_Handling_in_GNAT>` - :ref:`Overflow Check Handling in GNAT <Overflow_Check_Handling_in_GNAT>`
- :ref:`Performing Dimensionality Analysis in GNAT <Performing_Dimensionality_Analysis_in_GNAT>` - :ref:`Performing Dimensionality Analysis in GNAT <Performing_Dimensionality_Analysis_in_GNAT>`
......
gcc/ada/doc/gnat_ugn/gnat_and_program_execution.rst
...@@ -17,7 +17,7 @@ GNAT and Program Execution ...@@ -17,7 +17,7 @@ GNAT and Program Execution
This chapter covers several topics: This chapter covers several topics:
* `Running and Debugging Ada Programs`_ * `Running and Debugging Ada Programs`_
* `Code Coverage and Profiling`_ * `Profiling`_
* `Improving Performance`_ * `Improving Performance`_
* `Overflow Check Handling in GNAT`_ * `Overflow Check Handling in GNAT`_
* `Performing Dimensionality Analysis in GNAT`_ * `Performing Dimensionality Analysis in GNAT`_
...@@ -1206,103 +1206,16 @@ documentation ...@@ -1206,103 +1206,16 @@ documentation
for more information. for more information.
.. index:: Code Coverage
.. index:: Profiling .. index:: Profiling
.. _Code_Coverage_and_Profiling: .. _Profiling:
Code Coverage and Profiling Profiling
=========================== =========
This section describes how to use the ``gcov`` coverage testing tool and
the ``gprof`` profiler tool on Ada programs.
.. index:: ! gcov
.. _Code_Coverage_of_Ada_Programs_with_gcov:
Code Coverage of Ada Programs with gcov
---------------------------------------
``gcov`` is a test coverage program: it analyzes the execution of a given
program on selected tests, to help you determine the portions of the program
that are still untested.
``gcov`` is part of the GCC suite, and is described in detail in the GCC
User's Guide. You can refer to this documentation for a more complete
description.
This chapter provides a quick startup guide, and
details some GNAT-specific features.
.. _Quick_startup_guide:
Quick startup guide
^^^^^^^^^^^^^^^^^^^
In order to perform coverage analysis of a program using ``gcov``, several
steps are needed:
#. Instrument the code during the compilation process,
#. Execute the instrumented program, and
#. Invoke the ``gcov`` tool to generate the coverage results.
.. index:: -fprofile-arcs (gcc)
.. index:: -ftest-coverage (gcc
.. index:: -fprofile-arcs (gnatbind)
The code instrumentation needed by gcov is created at the object level.
The source code is not modified in any way, because the instrumentation code is
inserted by gcc during the compilation process. To compile your code with code
coverage activated, you need to recompile your whole project using the
switches
:switch:`-fprofile-arcs` and :switch:`-ftest-coverage`, and link it using
:switch:`-fprofile-arcs`.
::
$ gnatmake -P my_project.gpr -f -cargs -fprofile-arcs -ftest-coverage \\
-largs -fprofile-arcs
This compilation process will create :file:`.gcno` files together with
the usual object files.
Once the program is compiled with coverage instrumentation, you can
run it as many times as needed -- on portions of a test suite for
example. The first execution will produce :file:`.gcda` files at the
same location as the :file:`.gcno` files. Subsequent executions
will update those files, so that a cumulative result of the covered
portions of the program is generated.
Finally, you need to call the ``gcov`` tool. The different options of
``gcov`` are described in the GCC User's Guide, section *Invoking gcov*.
This will create annotated source files with a :file:`.gcov` extension:
:file:`my_main.adb` file will be analyzed in :file:`my_main.adb.gcov`.
.. _GNAT_specifics:
GNAT specifics
^^^^^^^^^^^^^^
Because of Ada semantics, portions of the source code may be shared among
several object files. This is the case for example when generics are
involved, when inlining is active or when declarations generate initialisation
calls. In order to take
into account this shared code, you need to call ``gcov`` on all
source files of the tested program at once.
The list of source files might exceed the system's maximum command line
length. In order to bypass this limitation, a new mechanism has been
implemented in ``gcov``: you can now list all your project's files into a
text file, and provide this file to gcov as a parameter, preceded by a ``@``
(e.g. :samp:`gcov @mysrclist.txt`).
Note that on AIX compiling a static library with :switch:`-fprofile-arcs` is
not supported as there can be unresolved symbols during the final link.
This section describes how to use the the ``gprof`` profiler tool on Ada
programs.
.. index:: ! gprof .. index:: ! gprof
.. index:: Profiling .. index:: Profiling
...@@ -1324,7 +1237,6 @@ better handle Ada programs and multitasking. ...@@ -1324,7 +1237,6 @@ better handle Ada programs and multitasking.
It is currently supported on the following platforms It is currently supported on the following platforms
* linux x86/x86_64 * linux x86/x86_64
* solaris sparc/sparc64/x86
* windows x86 * windows x86
In order to profile a program using ``gprof``, several steps are needed: In order to profile a program using ``gprof``, several steps are needed:
......
gcc/ada/gnat_ugn.texi
...@@ -21,7 +21,7 @@ ...@@ -21,7 +21,7 @@
@copying @copying
@quotation @quotation
GNAT User's Guide for Native Platforms , May 22, 2018 GNAT User's Guide for Native Platforms , Jul 13, 2018
AdaCore AdaCore
...@@ -349,7 +349,7 @@ The Ada to HTML Converter gnathtml ...@@ -349,7 +349,7 @@ The Ada to HTML Converter gnathtml
GNAT and Program Execution GNAT and Program Execution
* Running and Debugging Ada Programs:: * Running and Debugging Ada Programs::
* Code Coverage and Profiling:: * Profiling::
* Improving Performance:: * Improving Performance::
* Overflow Check Handling in GNAT:: * Overflow Check Handling in GNAT::
* Performing Dimensionality Analysis in GNAT:: * Performing Dimensionality Analysis in GNAT::
...@@ -379,16 +379,10 @@ Stack Traceback ...@@ -379,16 +379,10 @@ Stack Traceback
* Non-Symbolic Traceback:: * Non-Symbolic Traceback::
* Symbolic Traceback:: * Symbolic Traceback::
Code Coverage and Profiling Profiling
* Code Coverage of Ada Programs with gcov::
* Profiling an Ada Program with gprof:: * Profiling an Ada Program with gprof::
Code Coverage of Ada Programs with gcov
* Quick startup guide::
* GNAT specifics::
Profiling an Ada Program with gprof Profiling an Ada Program with gprof
* Compilation for profiling:: * Compilation for profiling::
...@@ -804,7 +798,7 @@ GNAT tools: ...@@ -804,7 +798,7 @@ GNAT tools:
@ref{24,,Running and Debugging Ada Programs} @ref{24,,Running and Debugging Ada Programs}
@item @item
@ref{25,,Code Coverage and Profiling} @ref{25,,Profiling}
@item @item
@ref{26,,Improving Performance} @ref{26,,Improving Performance}
...@@ -18955,27 +18949,27 @@ This chapter covers several topics: ...@@ -18955,27 +18949,27 @@ This chapter covers several topics:
@ref{167,,Running and Debugging Ada Programs} @ref{167,,Running and Debugging Ada Programs}
@item @item
@ref{168,,Code Coverage and Profiling} @ref{25,,Profiling}
@item @item
@ref{169,,Improving Performance} @ref{168,,Improving Performance}
@item @item
@ref{16a,,Overflow Check Handling in GNAT} @ref{169,,Overflow Check Handling in GNAT}
@item @item
@ref{16b,,Performing Dimensionality Analysis in GNAT} @ref{16a,,Performing Dimensionality Analysis in GNAT}
@item @item
@ref{16c,,Stack Related Facilities} @ref{16b,,Stack Related Facilities}
@item @item
@ref{16d,,Memory Management Issues} @ref{16c,,Memory Management Issues}
@end itemize @end itemize
@menu @menu
* Running and Debugging Ada Programs:: * Running and Debugging Ada Programs::
* Code Coverage and Profiling:: * Profiling::
* Improving Performance:: * Improving Performance::
* Overflow Check Handling in GNAT:: * Overflow Check Handling in GNAT::
* Performing Dimensionality Analysis in GNAT:: * Performing Dimensionality Analysis in GNAT::
...@@ -18984,7 +18978,7 @@ This chapter covers several topics: ...@@ -18984,7 +18978,7 @@ This chapter covers several topics:
@end menu @end menu
@node Running and Debugging Ada Programs,Code Coverage and Profiling,,GNAT and Program Execution @node Running and Debugging Ada Programs,Profiling,,GNAT and Program Execution
@anchor{gnat_ugn/gnat_and_program_execution id2}@anchor{167}@anchor{gnat_ugn/gnat_and_program_execution running-and-debugging-ada-programs}@anchor{24} @anchor{gnat_ugn/gnat_and_program_execution id2}@anchor{167}@anchor{gnat_ugn/gnat_and_program_execution running-and-debugging-ada-programs}@anchor{24}
@section Running and Debugging Ada Programs @section Running and Debugging Ada Programs
...@@ -19039,7 +19033,7 @@ the incorrect user program. ...@@ -19039,7 +19033,7 @@ the incorrect user program.
@end menu @end menu
@node The GNAT Debugger GDB,Running GDB,,Running and Debugging Ada Programs @node The GNAT Debugger GDB,Running GDB,,Running and Debugging Ada Programs
@anchor{gnat_ugn/gnat_and_program_execution the-gnat-debugger-gdb}@anchor{16e}@anchor{gnat_ugn/gnat_and_program_execution id3}@anchor{16f} @anchor{gnat_ugn/gnat_and_program_execution the-gnat-debugger-gdb}@anchor{16d}@anchor{gnat_ugn/gnat_and_program_execution id3}@anchor{16e}
@subsection The GNAT Debugger GDB @subsection The GNAT Debugger GDB
...@@ -19096,7 +19090,7 @@ the debugging information and can respond to user commands to inspect ...@@ -19096,7 +19090,7 @@ the debugging information and can respond to user commands to inspect
variables, and more generally to report on the state of execution. 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 @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{170}@anchor{gnat_ugn/gnat_and_program_execution running-gdb}@anchor{171} @anchor{gnat_ugn/gnat_and_program_execution id4}@anchor{16f}@anchor{gnat_ugn/gnat_and_program_execution running-gdb}@anchor{170}
@subsection Running GDB @subsection Running GDB
...@@ -19123,7 +19117,7 @@ exactly as if the debugger were not present. The following section ...@@ -19123,7 +19117,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}. 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 @node Introduction to GDB Commands,Using Ada Expressions,Running GDB,Running and Debugging Ada Programs
@anchor{gnat_ugn/gnat_and_program_execution introduction-to-gdb-commands}@anchor{172}@anchor{gnat_ugn/gnat_and_program_execution id5}@anchor{173} @anchor{gnat_ugn/gnat_and_program_execution introduction-to-gdb-commands}@anchor{171}@anchor{gnat_ugn/gnat_and_program_execution id5}@anchor{172}
@subsection Introduction to GDB Commands @subsection Introduction to GDB Commands
...@@ -19331,7 +19325,7 @@ Note that most commands can be abbreviated ...@@ -19331,7 +19325,7 @@ Note that most commands can be abbreviated
(for example, c for continue, bt for backtrace). (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 @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{174}@anchor{gnat_ugn/gnat_and_program_execution using-ada-expressions}@anchor{175} @anchor{gnat_ugn/gnat_and_program_execution id6}@anchor{173}@anchor{gnat_ugn/gnat_and_program_execution using-ada-expressions}@anchor{174}
@subsection Using Ada Expressions @subsection Using Ada Expressions
...@@ -19369,7 +19363,7 @@ their packages, regardless of context. Where this causes ambiguity, ...@@ -19369,7 +19363,7 @@ their packages, regardless of context. Where this causes ambiguity,
For details on the supported Ada syntax, see @cite{Debugging with GDB}. 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 @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 id7}@anchor{176}@anchor{gnat_ugn/gnat_and_program_execution calling-user-defined-subprograms}@anchor{177} @anchor{gnat_ugn/gnat_and_program_execution id7}@anchor{175}@anchor{gnat_ugn/gnat_and_program_execution calling-user-defined-subprograms}@anchor{176}
@subsection Calling User-Defined Subprograms @subsection Calling User-Defined Subprograms
...@@ -19428,7 +19422,7 @@ elements directly from GDB, you can write a callable procedure that prints ...@@ -19428,7 +19422,7 @@ elements directly from GDB, you can write a callable procedure that prints
the elements in the desired format. 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 @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 using-the-next-command-in-a-function}@anchor{178}@anchor{gnat_ugn/gnat_and_program_execution id8}@anchor{179} @anchor{gnat_ugn/gnat_and_program_execution using-the-next-command-in-a-function}@anchor{177}@anchor{gnat_ugn/gnat_and_program_execution id8}@anchor{178}
@subsection Using the @emph{next} Command in a Function @subsection Using the @emph{next} Command in a Function
...@@ -19451,7 +19445,7 @@ The value returned is always that from the first return statement ...@@ -19451,7 +19445,7 @@ The value returned is always that from the first return statement
that was stepped through. 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 @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 stopping-when-ada-exceptions-are-raised}@anchor{17a}@anchor{gnat_ugn/gnat_and_program_execution id9}@anchor{17b} @anchor{gnat_ugn/gnat_and_program_execution stopping-when-ada-exceptions-are-raised}@anchor{179}@anchor{gnat_ugn/gnat_and_program_execution id9}@anchor{17a}
@subsection Stopping When Ada Exceptions Are Raised @subsection Stopping When Ada Exceptions Are Raised
...@@ -19508,7 +19502,7 @@ argument, prints out only those exceptions whose name matches @emph{regexp}. ...@@ -19508,7 +19502,7 @@ argument, prints out only those exceptions whose name matches @emph{regexp}.
@geindex Tasks (in gdb) @geindex Tasks (in gdb)
@node Ada Tasks,Debugging Generic Units,Stopping When Ada Exceptions Are Raised,Running and Debugging Ada Programs @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{17c}@anchor{gnat_ugn/gnat_and_program_execution id10}@anchor{17d} @anchor{gnat_ugn/gnat_and_program_execution ada-tasks}@anchor{17b}@anchor{gnat_ugn/gnat_and_program_execution id10}@anchor{17c}
@subsection Ada Tasks @subsection Ada Tasks
...@@ -19595,7 +19589,7 @@ see @cite{Debugging with GDB}. ...@@ -19595,7 +19589,7 @@ see @cite{Debugging with GDB}.
@geindex Generics @geindex Generics
@node Debugging Generic Units,Remote Debugging with gdbserver,Ada Tasks,Running and Debugging Ada Programs @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{17e}@anchor{gnat_ugn/gnat_and_program_execution id11}@anchor{17f} @anchor{gnat_ugn/gnat_and_program_execution debugging-generic-units}@anchor{17d}@anchor{gnat_ugn/gnat_and_program_execution id11}@anchor{17e}
@subsection Debugging Generic Units @subsection Debugging Generic Units
...@@ -19654,7 +19648,7 @@ other units. ...@@ -19654,7 +19648,7 @@ other units.
@geindex Remote Debugging with gdbserver @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 @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 remote-debugging-with-gdbserver}@anchor{180}@anchor{gnat_ugn/gnat_and_program_execution id12}@anchor{181} @anchor{gnat_ugn/gnat_and_program_execution remote-debugging-with-gdbserver}@anchor{17f}@anchor{gnat_ugn/gnat_and_program_execution id12}@anchor{180}
@subsection Remote Debugging with gdbserver @subsection Remote Debugging with gdbserver
...@@ -19712,7 +19706,7 @@ GNAT provides support for gdbserver on x86-linux, x86-windows and x86_64-linux. ...@@ -19712,7 +19706,7 @@ GNAT provides support for gdbserver on x86-linux, x86-windows and x86_64-linux.
@geindex Abnormal Termination or Failure to Terminate @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 @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{182}@anchor{gnat_ugn/gnat_and_program_execution id13}@anchor{183} @anchor{gnat_ugn/gnat_and_program_execution gnat-abnormal-termination-or-failure-to-terminate}@anchor{181}@anchor{gnat_ugn/gnat_and_program_execution id13}@anchor{182}
@subsection GNAT Abnormal Termination or Failure to Terminate @subsection GNAT Abnormal Termination or Failure to Terminate
...@@ -19767,7 +19761,7 @@ Finally, you can start ...@@ -19767,7 +19761,7 @@ Finally, you can start
@code{gdb} directly on the @code{gnat1} executable. @code{gnat1} is the @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 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 called from @code{gcc}). You can use @code{gdb} on @code{gnat1} as you
would on a C program (but @ref{16e,,The GNAT Debugger GDB} for caveats). The would on a C program (but @ref{16d,,The GNAT Debugger GDB} for caveats). The
@code{where} command is the first line of attack; the variable @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{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 @code{gnat1} and by the @code{gcc} backend, indicates the source line at
...@@ -19776,7 +19770,7 @@ the source file. ...@@ -19776,7 +19770,7 @@ the source file.
@end itemize @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 @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 naming-conventions-for-gnat-source-files}@anchor{184}@anchor{gnat_ugn/gnat_and_program_execution id14}@anchor{185} @anchor{gnat_ugn/gnat_and_program_execution naming-conventions-for-gnat-source-files}@anchor{183}@anchor{gnat_ugn/gnat_and_program_execution id14}@anchor{184}
@subsection Naming Conventions for GNAT Source Files @subsection Naming Conventions for GNAT Source Files
...@@ -19857,7 +19851,7 @@ the other @code{.c} files are modifications of common @code{gcc} files. ...@@ -19857,7 +19851,7 @@ the other @code{.c} files are modifications of common @code{gcc} files.
@end itemize @end itemize
@node Getting Internal Debugging Information,Stack Traceback,Naming Conventions for GNAT Source Files,Running and Debugging Ada Programs @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 id15}@anchor{186}@anchor{gnat_ugn/gnat_and_program_execution getting-internal-debugging-information}@anchor{187} @anchor{gnat_ugn/gnat_and_program_execution id15}@anchor{185}@anchor{gnat_ugn/gnat_and_program_execution getting-internal-debugging-information}@anchor{186}
@subsection Getting Internal Debugging Information @subsection Getting Internal Debugging Information
...@@ -19885,7 +19879,7 @@ are replaced with run-time calls. ...@@ -19885,7 +19879,7 @@ are replaced with run-time calls.
@geindex stack unwinding @geindex stack unwinding
@node Stack Traceback,Pretty-Printers for the GNAT runtime,Getting Internal Debugging Information,Running and Debugging Ada Programs @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 stack-traceback}@anchor{188}@anchor{gnat_ugn/gnat_and_program_execution id16}@anchor{189} @anchor{gnat_ugn/gnat_and_program_execution stack-traceback}@anchor{187}@anchor{gnat_ugn/gnat_and_program_execution id16}@anchor{188}
@subsection Stack Traceback @subsection Stack Traceback
...@@ -19914,7 +19908,7 @@ is enabled, and no exception is raised during program execution. ...@@ -19914,7 +19908,7 @@ is enabled, and no exception is raised during program execution.
@end menu @end menu
@node Non-Symbolic Traceback,Symbolic Traceback,,Stack Traceback @node Non-Symbolic Traceback,Symbolic Traceback,,Stack Traceback
@anchor{gnat_ugn/gnat_and_program_execution non-symbolic-traceback}@anchor{18a}@anchor{gnat_ugn/gnat_and_program_execution id17}@anchor{18b} @anchor{gnat_ugn/gnat_and_program_execution non-symbolic-traceback}@anchor{189}@anchor{gnat_ugn/gnat_and_program_execution id17}@anchor{18a}
@subsubsection Non-Symbolic Traceback @subsubsection Non-Symbolic Traceback
...@@ -20199,7 +20193,7 @@ need to be specified in C format, with a leading '0x'). ...@@ -20199,7 +20193,7 @@ need to be specified in C format, with a leading '0x').
@geindex symbolic @geindex symbolic
@node Symbolic Traceback,,Non-Symbolic Traceback,Stack Traceback @node Symbolic Traceback,,Non-Symbolic Traceback,Stack Traceback
@anchor{gnat_ugn/gnat_and_program_execution id18}@anchor{18c}@anchor{gnat_ugn/gnat_and_program_execution symbolic-traceback}@anchor{18d} @anchor{gnat_ugn/gnat_and_program_execution id18}@anchor{18b}@anchor{gnat_ugn/gnat_and_program_execution symbolic-traceback}@anchor{18c}
@subsubsection Symbolic Traceback @subsubsection Symbolic Traceback
...@@ -20327,7 +20321,7 @@ which will also be printed if an unhandled exception terminates the ...@@ -20327,7 +20321,7 @@ which will also be printed if an unhandled exception terminates the
program. program.
@node Pretty-Printers for the GNAT runtime,,Stack Traceback,Running and Debugging Ada Programs @node Pretty-Printers for the GNAT runtime,,Stack Traceback,Running and Debugging Ada Programs
@anchor{gnat_ugn/gnat_and_program_execution id19}@anchor{18e}@anchor{gnat_ugn/gnat_and_program_execution pretty-printers-for-the-gnat-runtime}@anchor{18f} @anchor{gnat_ugn/gnat_and_program_execution id19}@anchor{18d}@anchor{gnat_ugn/gnat_and_program_execution pretty-printers-for-the-gnat-runtime}@anchor{18e}
@subsection Pretty-Printers for the GNAT runtime @subsection Pretty-Printers for the GNAT runtime
...@@ -20431,134 +20425,27 @@ $1 = ( ...@@ -20431,134 +20425,27 @@ $1 = (
Finer control of pretty-printers is also possible: see GDB's online documentation@footnote{http://docs.adacore.com/gdb-docs/html/gdb.html#Pretty_002dPrinter-Commands} Finer control of pretty-printers is also possible: see GDB's online documentation@footnote{http://docs.adacore.com/gdb-docs/html/gdb.html#Pretty_002dPrinter-Commands}
for more information. for more information.
@geindex Code Coverage
@geindex Profiling @geindex Profiling
@node Code Coverage and Profiling,Improving Performance,Running and Debugging Ada Programs,GNAT and Program Execution @node Profiling,Improving Performance,Running and Debugging Ada Programs,GNAT and Program Execution
@anchor{gnat_ugn/gnat_and_program_execution id20}@anchor{168}@anchor{gnat_ugn/gnat_and_program_execution code-coverage-and-profiling}@anchor{25} @anchor{gnat_ugn/gnat_and_program_execution profiling}@anchor{25}@anchor{gnat_ugn/gnat_and_program_execution id20}@anchor{18f}
@section Code Coverage and Profiling @section Profiling
This section describes how to use the @code{gcov} coverage testing tool and
the @code{gprof} profiler tool on Ada programs.
@geindex gcov
@menu
* Code Coverage of Ada Programs with gcov::
* Profiling an Ada Program with gprof::
@end menu
@node Code Coverage of Ada Programs with gcov,Profiling an Ada Program with gprof,,Code Coverage and Profiling
@anchor{gnat_ugn/gnat_and_program_execution id21}@anchor{190}@anchor{gnat_ugn/gnat_and_program_execution code-coverage-of-ada-programs-with-gcov}@anchor{191}
@subsection Code Coverage of Ada Programs with gcov
This section describes how to use the the @code{gprof} profiler tool on Ada
programs.
@code{gcov} is a test coverage program: it analyzes the execution of a given @geindex gprof
program on selected tests, to help you determine the portions of the program
that are still untested.
@code{gcov} is part of the GCC suite, and is described in detail in the GCC
User's Guide. You can refer to this documentation for a more complete
description.
This chapter provides a quick startup guide, and @geindex Profiling
details some GNAT-specific features.
@menu @menu
* Quick startup guide:: * Profiling an Ada Program with gprof::
* GNAT specifics::
@end menu @end menu
@node Quick startup guide,GNAT specifics,,Code Coverage of Ada Programs with gcov @node Profiling an Ada Program with gprof,,,Profiling
@anchor{gnat_ugn/gnat_and_program_execution id22}@anchor{192}@anchor{gnat_ugn/gnat_and_program_execution quick-startup-guide}@anchor{193} @anchor{gnat_ugn/gnat_and_program_execution id21}@anchor{190}@anchor{gnat_ugn/gnat_and_program_execution profiling-an-ada-program-with-gprof}@anchor{191}
@subsubsection Quick startup guide
In order to perform coverage analysis of a program using @code{gcov}, several
steps are needed:
@enumerate
@item
Instrument the code during the compilation process,
@item
Execute the instrumented program, and
@item
Invoke the @code{gcov} tool to generate the coverage results.
@end enumerate
@geindex -fprofile-arcs (gcc)
@geindex -ftest-coverage (gcc
@geindex -fprofile-arcs (gnatbind)
The code instrumentation needed by gcov is created at the object level.
The source code is not modified in any way, because the instrumentation code is
inserted by gcc during the compilation process. To compile your code with code
coverage activated, you need to recompile your whole project using the
switches
@code{-fprofile-arcs} and @code{-ftest-coverage}, and link it using
@code{-fprofile-arcs}.
@quotation
@example
$ gnatmake -P my_project.gpr -f -cargs -fprofile-arcs -ftest-coverage \\
-largs -fprofile-arcs
@end example
@end quotation
This compilation process will create @code{.gcno} files together with
the usual object files.
Once the program is compiled with coverage instrumentation, you can
run it as many times as needed -- on portions of a test suite for
example. The first execution will produce @code{.gcda} files at the
same location as the @code{.gcno} files. Subsequent executions
will update those files, so that a cumulative result of the covered
portions of the program is generated.
Finally, you need to call the @code{gcov} tool. The different options of
@code{gcov} are described in the GCC User's Guide, section @emph{Invoking gcov}.
This will create annotated source files with a @code{.gcov} extension:
@code{my_main.adb} file will be analyzed in @code{my_main.adb.gcov}.
@node GNAT specifics,,Quick startup guide,Code Coverage of Ada Programs with gcov
@anchor{gnat_ugn/gnat_and_program_execution gnat-specifics}@anchor{194}@anchor{gnat_ugn/gnat_and_program_execution id23}@anchor{195}
@subsubsection GNAT specifics
Because of Ada semantics, portions of the source code may be shared among
several object files. This is the case for example when generics are
involved, when inlining is active or when declarations generate initialisation
calls. In order to take
into account this shared code, you need to call @code{gcov} on all
source files of the tested program at once.
The list of source files might exceed the system's maximum command line
length. In order to bypass this limitation, a new mechanism has been
implemented in @code{gcov}: you can now list all your project's files into a
text file, and provide this file to gcov as a parameter, preceded by a @code{@@}
(e.g. @code{gcov @@mysrclist.txt}).
Note that on AIX compiling a static library with @code{-fprofile-arcs} is
not supported as there can be unresolved symbols during the final link.
@geindex gprof
@geindex Profiling
@node Profiling an Ada Program with gprof,,Code Coverage of Ada Programs with gcov,Code Coverage and Profiling
@anchor{gnat_ugn/gnat_and_program_execution profiling-an-ada-program-with-gprof}@anchor{196}@anchor{gnat_ugn/gnat_and_program_execution id24}@anchor{197}
@subsection Profiling an Ada Program with gprof @subsection Profiling an Ada Program with gprof
...@@ -20580,9 +20467,6 @@ It is currently supported on the following platforms ...@@ -20580,9 +20467,6 @@ It is currently supported on the following platforms
linux x86/x86_64 linux x86/x86_64
@item @item
solaris sparc/sparc64/x86
@item
windows x86 windows x86
@end itemize @end itemize
...@@ -20615,7 +20499,7 @@ to interpret the results. ...@@ -20615,7 +20499,7 @@ to interpret the results.
@end menu @end menu
@node Compilation for profiling,Program execution,,Profiling an Ada Program with gprof @node Compilation for profiling,Program execution,,Profiling an Ada Program with gprof
@anchor{gnat_ugn/gnat_and_program_execution id25}@anchor{198}@anchor{gnat_ugn/gnat_and_program_execution compilation-for-profiling}@anchor{199} @anchor{gnat_ugn/gnat_and_program_execution id22}@anchor{192}@anchor{gnat_ugn/gnat_and_program_execution compilation-for-profiling}@anchor{193}
@subsubsection Compilation for profiling @subsubsection Compilation for profiling
...@@ -20643,7 +20527,7 @@ be profiled; if you need to profile your whole project, use the @code{-f} ...@@ -20643,7 +20527,7 @@ be profiled; if you need to profile your whole project, use the @code{-f}
gnatmake switch to force full recompilation. gnatmake switch to force full recompilation.
@node Program execution,Running gprof,Compilation for profiling,Profiling an Ada Program with gprof @node Program execution,Running gprof,Compilation for profiling,Profiling an Ada Program with gprof
@anchor{gnat_ugn/gnat_and_program_execution program-execution}@anchor{19a}@anchor{gnat_ugn/gnat_and_program_execution id26}@anchor{19b} @anchor{gnat_ugn/gnat_and_program_execution program-execution}@anchor{194}@anchor{gnat_ugn/gnat_and_program_execution id23}@anchor{195}
@subsubsection Program execution @subsubsection Program execution
...@@ -20658,7 +20542,7 @@ generated in the directory where the program was launched from. If this file ...@@ -20658,7 +20542,7 @@ generated in the directory where the program was launched from. If this file
already exists, it will be overwritten. already exists, it will be overwritten.
@node Running gprof,Interpretation of profiling results,Program execution,Profiling an Ada Program with gprof @node Running gprof,Interpretation of profiling results,Program execution,Profiling an Ada Program with gprof
@anchor{gnat_ugn/gnat_and_program_execution running-gprof}@anchor{19c}@anchor{gnat_ugn/gnat_and_program_execution id27}@anchor{19d} @anchor{gnat_ugn/gnat_and_program_execution running-gprof}@anchor{196}@anchor{gnat_ugn/gnat_and_program_execution id24}@anchor{197}
@subsubsection Running gprof @subsubsection Running gprof
...@@ -20771,7 +20655,7 @@ may be given; only one @code{function_name} may be indicated with each ...@@ -20771,7 +20655,7 @@ may be given; only one @code{function_name} may be indicated with each
@end table @end table
@node Interpretation of profiling results,,Running gprof,Profiling an Ada Program with gprof @node Interpretation of profiling results,,Running gprof,Profiling an Ada Program with gprof
@anchor{gnat_ugn/gnat_and_program_execution id28}@anchor{19e}@anchor{gnat_ugn/gnat_and_program_execution interpretation-of-profiling-results}@anchor{19f} @anchor{gnat_ugn/gnat_and_program_execution id25}@anchor{198}@anchor{gnat_ugn/gnat_and_program_execution interpretation-of-profiling-results}@anchor{199}
@subsubsection Interpretation of profiling results @subsubsection Interpretation of profiling results
...@@ -20787,8 +20671,8 @@ The call graph shows, for each subprogram, the subprograms that call it, ...@@ -20787,8 +20671,8 @@ The call graph shows, for each subprogram, the subprograms that call it,
and the subprograms that it calls. It also provides an estimate of the time and the subprograms that it calls. It also provides an estimate of the time
spent in each of those callers/called subprograms. spent in each of those callers/called subprograms.
@node Improving Performance,Overflow Check Handling in GNAT,Code Coverage and Profiling,GNAT and Program Execution @node Improving Performance,Overflow Check Handling in GNAT,Profiling,GNAT and Program Execution
@anchor{gnat_ugn/gnat_and_program_execution id29}@anchor{169}@anchor{gnat_ugn/gnat_and_program_execution improving-performance}@anchor{26} @anchor{gnat_ugn/gnat_and_program_execution improving-performance}@anchor{26}@anchor{gnat_ugn/gnat_and_program_execution id26}@anchor{168}
@section Improving Performance @section Improving Performance
...@@ -20810,7 +20694,7 @@ which can reduce the size of program executables. ...@@ -20810,7 +20694,7 @@ which can reduce the size of program executables.
@end menu @end menu
@node Performance Considerations,Text_IO Suggestions,,Improving Performance @node Performance Considerations,Text_IO Suggestions,,Improving Performance
@anchor{gnat_ugn/gnat_and_program_execution performance-considerations}@anchor{1a0}@anchor{gnat_ugn/gnat_and_program_execution id30}@anchor{1a1} @anchor{gnat_ugn/gnat_and_program_execution performance-considerations}@anchor{19a}@anchor{gnat_ugn/gnat_and_program_execution id27}@anchor{19b}
@subsection Performance Considerations @subsection Performance Considerations
...@@ -20871,7 +20755,7 @@ some guidelines on debugging optimized code. ...@@ -20871,7 +20755,7 @@ some guidelines on debugging optimized code.
@end menu @end menu
@node Controlling Run-Time Checks,Use of Restrictions,,Performance Considerations @node Controlling Run-Time Checks,Use of Restrictions,,Performance Considerations
@anchor{gnat_ugn/gnat_and_program_execution controlling-run-time-checks}@anchor{1a2}@anchor{gnat_ugn/gnat_and_program_execution id31}@anchor{1a3} @anchor{gnat_ugn/gnat_and_program_execution id28}@anchor{19c}@anchor{gnat_ugn/gnat_and_program_execution controlling-run-time-checks}@anchor{19d}
@subsubsection Controlling Run-Time Checks @subsubsection Controlling Run-Time Checks
...@@ -20923,7 +20807,7 @@ remove checks) or @code{pragma Unsuppress} (to add back suppressed ...@@ -20923,7 +20807,7 @@ remove checks) or @code{pragma Unsuppress} (to add back suppressed
checks) in the program source. checks) in the program source.
@node Use of Restrictions,Optimization Levels,Controlling Run-Time Checks,Performance Considerations @node Use of Restrictions,Optimization Levels,Controlling Run-Time Checks,Performance Considerations
@anchor{gnat_ugn/gnat_and_program_execution id32}@anchor{1a4}@anchor{gnat_ugn/gnat_and_program_execution use-of-restrictions}@anchor{1a5} @anchor{gnat_ugn/gnat_and_program_execution id29}@anchor{19e}@anchor{gnat_ugn/gnat_and_program_execution use-of-restrictions}@anchor{19f}
@subsubsection Use of Restrictions @subsubsection Use of Restrictions
...@@ -20958,7 +20842,7 @@ that this also means that you can write code without worrying about the ...@@ -20958,7 +20842,7 @@ that this also means that you can write code without worrying about the
possibility of an immediate abort at any point. possibility of an immediate abort at any point.
@node Optimization Levels,Debugging Optimized Code,Use of Restrictions,Performance Considerations @node Optimization Levels,Debugging Optimized Code,Use of Restrictions,Performance Considerations
@anchor{gnat_ugn/gnat_and_program_execution id33}@anchor{1a6}@anchor{gnat_ugn/gnat_and_program_execution optimization-levels}@anchor{fc} @anchor{gnat_ugn/gnat_and_program_execution id30}@anchor{1a0}@anchor{gnat_ugn/gnat_and_program_execution optimization-levels}@anchor{fc}
@subsubsection Optimization Levels @subsubsection Optimization Levels
...@@ -21082,7 +20966,7 @@ since it often results in larger executables which may run more slowly. ...@@ -21082,7 +20966,7 @@ since it often results in larger executables which may run more slowly.
See further discussion of this point in @ref{10f,,Inlining of Subprograms}. See further discussion of this point in @ref{10f,,Inlining of Subprograms}.
@node Debugging Optimized Code,Inlining of Subprograms,Optimization Levels,Performance Considerations @node Debugging Optimized Code,Inlining of Subprograms,Optimization Levels,Performance Considerations
@anchor{gnat_ugn/gnat_and_program_execution id34}@anchor{1a7}@anchor{gnat_ugn/gnat_and_program_execution debugging-optimized-code}@anchor{1a8} @anchor{gnat_ugn/gnat_and_program_execution debugging-optimized-code}@anchor{1a1}@anchor{gnat_ugn/gnat_and_program_execution id31}@anchor{1a2}
@subsubsection Debugging Optimized Code @subsubsection Debugging Optimized Code
...@@ -21210,7 +21094,7 @@ on the resulting executable, ...@@ -21210,7 +21094,7 @@ on the resulting executable,
which removes both debugging information and global symbols. which removes both debugging information and global symbols.
@node Inlining of Subprograms,Floating_Point_Operations,Debugging Optimized Code,Performance Considerations @node Inlining of Subprograms,Floating_Point_Operations,Debugging Optimized Code,Performance Considerations
@anchor{gnat_ugn/gnat_and_program_execution id35}@anchor{1a9}@anchor{gnat_ugn/gnat_and_program_execution inlining-of-subprograms}@anchor{10f} @anchor{gnat_ugn/gnat_and_program_execution id32}@anchor{1a3}@anchor{gnat_ugn/gnat_and_program_execution inlining-of-subprograms}@anchor{10f}
@subsubsection Inlining of Subprograms @subsubsection Inlining of Subprograms
...@@ -21349,7 +21233,7 @@ indeed you should use @code{-O3} only if tests show that it actually ...@@ -21349,7 +21233,7 @@ indeed you should use @code{-O3} only if tests show that it actually
improves performance for your program. improves performance for your program.
@node Floating_Point_Operations,Vectorization of loops,Inlining of Subprograms,Performance Considerations @node Floating_Point_Operations,Vectorization of loops,Inlining of Subprograms,Performance Considerations
@anchor{gnat_ugn/gnat_and_program_execution id36}@anchor{1aa}@anchor{gnat_ugn/gnat_and_program_execution floating-point-operations}@anchor{1ab} @anchor{gnat_ugn/gnat_and_program_execution floating-point-operations}@anchor{1a4}@anchor{gnat_ugn/gnat_and_program_execution id33}@anchor{1a5}
@subsubsection Floating_Point_Operations @subsubsection Floating_Point_Operations
...@@ -21397,7 +21281,7 @@ so it is permissible to mix units compiled with and without these ...@@ -21397,7 +21281,7 @@ so it is permissible to mix units compiled with and without these
switches. switches.
@node Vectorization of loops,Other Optimization Switches,Floating_Point_Operations,Performance Considerations @node Vectorization of loops,Other Optimization Switches,Floating_Point_Operations,Performance Considerations
@anchor{gnat_ugn/gnat_and_program_execution id37}@anchor{1ac}@anchor{gnat_ugn/gnat_and_program_execution vectorization-of-loops}@anchor{1ad} @anchor{gnat_ugn/gnat_and_program_execution id34}@anchor{1a6}@anchor{gnat_ugn/gnat_and_program_execution vectorization-of-loops}@anchor{1a7}
@subsubsection Vectorization of loops @subsubsection Vectorization of loops
...@@ -21548,7 +21432,7 @@ placed immediately within the loop will tell the compiler that it can safely ...@@ -21548,7 +21432,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. 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 @node Other Optimization Switches,Optimization and Strict Aliasing,Vectorization of loops,Performance Considerations
@anchor{gnat_ugn/gnat_and_program_execution other-optimization-switches}@anchor{1ae}@anchor{gnat_ugn/gnat_and_program_execution id38}@anchor{1af} @anchor{gnat_ugn/gnat_and_program_execution other-optimization-switches}@anchor{1a8}@anchor{gnat_ugn/gnat_and_program_execution id35}@anchor{1a9}
@subsubsection Other Optimization Switches @subsubsection Other Optimization Switches
...@@ -21565,7 +21449,7 @@ the @emph{Submodel Options} section in the @emph{Hardware Models and Configurati ...@@ -21565,7 +21449,7 @@ the @emph{Submodel Options} section in the @emph{Hardware Models and Configurati
chapter of @cite{Using the GNU Compiler Collection (GCC)}. chapter of @cite{Using the GNU Compiler Collection (GCC)}.
@node Optimization and Strict Aliasing,Aliased Variables and Optimization,Other Optimization Switches,Performance Considerations @node Optimization and Strict Aliasing,Aliased Variables and Optimization,Other Optimization Switches,Performance Considerations
@anchor{gnat_ugn/gnat_and_program_execution optimization-and-strict-aliasing}@anchor{f3}@anchor{gnat_ugn/gnat_and_program_execution id39}@anchor{1b0} @anchor{gnat_ugn/gnat_and_program_execution optimization-and-strict-aliasing}@anchor{f3}@anchor{gnat_ugn/gnat_and_program_execution id36}@anchor{1aa}
@subsubsection Optimization and Strict Aliasing @subsubsection Optimization and Strict Aliasing
...@@ -21805,7 +21689,7 @@ review any uses of unchecked conversion of access types, ...@@ -21805,7 +21689,7 @@ review any uses of unchecked conversion of access types,
particularly if you are getting the warnings described above. particularly if you are getting the warnings described above.
@node Aliased Variables and Optimization,Atomic Variables and Optimization,Optimization and Strict Aliasing,Performance Considerations @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{1b1}@anchor{gnat_ugn/gnat_and_program_execution id40}@anchor{1b2} @anchor{gnat_ugn/gnat_and_program_execution id37}@anchor{1ab}@anchor{gnat_ugn/gnat_and_program_execution aliased-variables-and-optimization}@anchor{1ac}
@subsubsection Aliased Variables and Optimization @subsubsection Aliased Variables and Optimization
...@@ -21863,7 +21747,7 @@ This means that the above example will in fact "work" reliably, ...@@ -21863,7 +21747,7 @@ This means that the above example will in fact "work" reliably,
that is, it will produce the expected results. that is, it will produce the expected results.
@node Atomic Variables and Optimization,Passive Task Optimization,Aliased Variables and Optimization,Performance Considerations @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{1b3}@anchor{gnat_ugn/gnat_and_program_execution id41}@anchor{1b4} @anchor{gnat_ugn/gnat_and_program_execution atomic-variables-and-optimization}@anchor{1ad}@anchor{gnat_ugn/gnat_and_program_execution id38}@anchor{1ae}
@subsubsection Atomic Variables and Optimization @subsubsection Atomic Variables and Optimization
...@@ -21944,7 +21828,7 @@ such synchronization code is not required, it may be ...@@ -21944,7 +21828,7 @@ such synchronization code is not required, it may be
useful to disable it. useful to disable it.
@node Passive Task Optimization,,Atomic Variables and Optimization,Performance Considerations @node Passive Task Optimization,,Atomic Variables and Optimization,Performance Considerations
@anchor{gnat_ugn/gnat_and_program_execution id42}@anchor{1b5}@anchor{gnat_ugn/gnat_and_program_execution passive-task-optimization}@anchor{1b6} @anchor{gnat_ugn/gnat_and_program_execution passive-task-optimization}@anchor{1af}@anchor{gnat_ugn/gnat_and_program_execution id39}@anchor{1b0}
@subsubsection Passive Task Optimization @subsubsection Passive Task Optimization
...@@ -21989,7 +21873,7 @@ that typically clients of the tasks who call entries, will not have ...@@ -21989,7 +21873,7 @@ that typically clients of the tasks who call entries, will not have
to be modified, only the task definition itself. 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 @node Text_IO Suggestions,Reducing Size of Executables with Unused Subprogram/Data Elimination,Performance Considerations,Improving Performance
@anchor{gnat_ugn/gnat_and_program_execution text-io-suggestions}@anchor{1b7}@anchor{gnat_ugn/gnat_and_program_execution id43}@anchor{1b8} @anchor{gnat_ugn/gnat_and_program_execution text-io-suggestions}@anchor{1b1}@anchor{gnat_ugn/gnat_and_program_execution id40}@anchor{1b2}
@subsection @code{Text_IO} Suggestions @subsection @code{Text_IO} Suggestions
...@@ -22012,7 +21896,7 @@ of the standard output file, or change the standard output file to ...@@ -22012,7 +21896,7 @@ of the standard output file, or change the standard output file to
be buffered using @code{Interfaces.C_Streams.setvbuf}. be buffered using @code{Interfaces.C_Streams.setvbuf}.
@node Reducing Size of Executables with Unused Subprogram/Data Elimination,,Text_IO Suggestions,Improving Performance @node Reducing Size of Executables with Unused Subprogram/Data Elimination,,Text_IO Suggestions,Improving Performance
@anchor{gnat_ugn/gnat_and_program_execution id44}@anchor{1b9}@anchor{gnat_ugn/gnat_and_program_execution reducing-size-of-executables-with-unused-subprogram-data-elimination}@anchor{1ba} @anchor{gnat_ugn/gnat_and_program_execution id41}@anchor{1b3}@anchor{gnat_ugn/gnat_and_program_execution reducing-size-of-executables-with-unused-subprogram-data-elimination}@anchor{1b4}
@subsection Reducing Size of Executables with Unused Subprogram/Data Elimination @subsection Reducing Size of Executables with Unused Subprogram/Data Elimination
...@@ -22029,7 +21913,7 @@ your executable just by setting options at compilation time. ...@@ -22029,7 +21913,7 @@ your executable just by setting options at compilation time.
@end menu @end menu
@node About unused subprogram/data elimination,Compilation options,,Reducing Size of Executables with Unused Subprogram/Data Elimination @node About unused subprogram/data elimination,Compilation options,,Reducing Size of Executables with Unused Subprogram/Data Elimination
@anchor{gnat_ugn/gnat_and_program_execution id45}@anchor{1bb}@anchor{gnat_ugn/gnat_and_program_execution about-unused-subprogram-data-elimination}@anchor{1bc} @anchor{gnat_ugn/gnat_and_program_execution id42}@anchor{1b5}@anchor{gnat_ugn/gnat_and_program_execution about-unused-subprogram-data-elimination}@anchor{1b6}
@subsubsection About unused subprogram/data elimination @subsubsection About unused subprogram/data elimination
...@@ -22045,7 +21929,7 @@ architecture and on all cross platforms using the ELF binary file format. ...@@ -22045,7 +21929,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. 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 @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 id46}@anchor{1bd}@anchor{gnat_ugn/gnat_and_program_execution compilation-options}@anchor{1be} @anchor{gnat_ugn/gnat_and_program_execution id43}@anchor{1b7}@anchor{gnat_ugn/gnat_and_program_execution compilation-options}@anchor{1b8}
@subsubsection Compilation options @subsubsection Compilation options
...@@ -22084,7 +21968,7 @@ The GNAT static library is now compiled with -ffunction-sections and ...@@ -22084,7 +21968,7 @@ The GNAT static library is now compiled with -ffunction-sections and
and data of the GNAT library from your executable. 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 @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 id47}@anchor{1bf}@anchor{gnat_ugn/gnat_and_program_execution example-of-unused-subprogram-data-elimination}@anchor{1c0} @anchor{gnat_ugn/gnat_and_program_execution example-of-unused-subprogram-data-elimination}@anchor{1b9}@anchor{gnat_ugn/gnat_and_program_execution id44}@anchor{1ba}
@subsubsection Example of unused subprogram/data elimination @subsubsection Example of unused subprogram/data elimination
...@@ -22155,7 +22039,7 @@ appropriate options. ...@@ -22155,7 +22039,7 @@ appropriate options.
@node Overflow Check Handling in GNAT,Performing Dimensionality Analysis in GNAT,Improving Performance,GNAT and Program Execution @node Overflow Check Handling in GNAT,Performing Dimensionality Analysis in GNAT,Improving Performance,GNAT and Program Execution
@anchor{gnat_ugn/gnat_and_program_execution id53}@anchor{16a}@anchor{gnat_ugn/gnat_and_program_execution overflow-check-handling-in-gnat}@anchor{27} @anchor{gnat_ugn/gnat_and_program_execution id50}@anchor{169}@anchor{gnat_ugn/gnat_and_program_execution overflow-check-handling-in-gnat}@anchor{27}
@section Overflow Check Handling in GNAT @section Overflow Check Handling in GNAT
...@@ -22171,7 +22055,7 @@ This section explains how to control the handling of overflow checks. ...@@ -22171,7 +22055,7 @@ This section explains how to control the handling of overflow checks.
@end menu @end menu
@node Background,Management of Overflows in GNAT,,Overflow Check Handling in GNAT @node Background,Management of Overflows in GNAT,,Overflow Check Handling in GNAT
@anchor{gnat_ugn/gnat_and_program_execution id54}@anchor{1c1}@anchor{gnat_ugn/gnat_and_program_execution background}@anchor{1c2} @anchor{gnat_ugn/gnat_and_program_execution id51}@anchor{1bb}@anchor{gnat_ugn/gnat_and_program_execution background}@anchor{1bc}
@subsection Background @subsection Background
...@@ -22297,7 +22181,7 @@ exception raised because of the intermediate overflow (and we really ...@@ -22297,7 +22181,7 @@ exception raised because of the intermediate overflow (and we really
would prefer this precondition to be considered True at run time). 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 @node Management of Overflows in GNAT,Specifying the Desired Mode,Background,Overflow Check Handling in GNAT
@anchor{gnat_ugn/gnat_and_program_execution id55}@anchor{1c3}@anchor{gnat_ugn/gnat_and_program_execution management-of-overflows-in-gnat}@anchor{1c4} @anchor{gnat_ugn/gnat_and_program_execution management-of-overflows-in-gnat}@anchor{1bd}@anchor{gnat_ugn/gnat_and_program_execution id52}@anchor{1be}
@subsection Management of Overflows in GNAT @subsection Management of Overflows in GNAT
...@@ -22411,7 +22295,7 @@ out in the normal manner (with infinite values always failing all ...@@ -22411,7 +22295,7 @@ out in the normal manner (with infinite values always failing all
range checks). range checks).
@node Specifying the Desired Mode,Default Settings,Management of Overflows in GNAT,Overflow Check Handling in GNAT @node Specifying the Desired Mode,Default Settings,Management of Overflows in GNAT,Overflow Check Handling in GNAT
@anchor{gnat_ugn/gnat_and_program_execution id56}@anchor{1c5}@anchor{gnat_ugn/gnat_and_program_execution specifying-the-desired-mode}@anchor{f8} @anchor{gnat_ugn/gnat_and_program_execution specifying-the-desired-mode}@anchor{f8}@anchor{gnat_ugn/gnat_and_program_execution id53}@anchor{1bf}
@subsection Specifying the Desired Mode @subsection Specifying the Desired Mode
...@@ -22535,7 +22419,7 @@ causing all intermediate operations to be computed using the base ...@@ -22535,7 +22419,7 @@ causing all intermediate operations to be computed using the base
type (@code{STRICT} mode). type (@code{STRICT} mode).
@node Default Settings,Implementation Notes,Specifying the Desired Mode,Overflow Check Handling in GNAT @node Default Settings,Implementation Notes,Specifying the Desired Mode,Overflow Check Handling in GNAT
@anchor{gnat_ugn/gnat_and_program_execution id57}@anchor{1c6}@anchor{gnat_ugn/gnat_and_program_execution default-settings}@anchor{1c7} @anchor{gnat_ugn/gnat_and_program_execution id54}@anchor{1c0}@anchor{gnat_ugn/gnat_and_program_execution default-settings}@anchor{1c1}
@subsection Default Settings @subsection Default Settings
...@@ -22582,7 +22466,7 @@ checking, but it has no effect on the method used for computing ...@@ -22582,7 +22466,7 @@ checking, but it has no effect on the method used for computing
intermediate results. intermediate results.
@node Implementation Notes,,Default Settings,Overflow Check Handling in GNAT @node Implementation Notes,,Default Settings,Overflow Check Handling in GNAT
@anchor{gnat_ugn/gnat_and_program_execution implementation-notes}@anchor{1c8}@anchor{gnat_ugn/gnat_and_program_execution id58}@anchor{1c9} @anchor{gnat_ugn/gnat_and_program_execution id55}@anchor{1c2}@anchor{gnat_ugn/gnat_and_program_execution implementation-notes}@anchor{1c3}
@subsection Implementation Notes @subsection Implementation Notes
...@@ -22630,7 +22514,7 @@ platforms for which @code{Long_Long_Integer} is 64-bits (nearly all GNAT ...@@ -22630,7 +22514,7 @@ platforms for which @code{Long_Long_Integer} is 64-bits (nearly all GNAT
platforms). platforms).
@node Performing Dimensionality Analysis in GNAT,Stack Related Facilities,Overflow Check Handling in GNAT,GNAT and Program Execution @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 performing-dimensionality-analysis-in-gnat}@anchor{28}@anchor{gnat_ugn/gnat_and_program_execution id59}@anchor{16b} @anchor{gnat_ugn/gnat_and_program_execution id56}@anchor{16a}@anchor{gnat_ugn/gnat_and_program_execution performing-dimensionality-analysis-in-gnat}@anchor{28}
@section Performing Dimensionality Analysis in GNAT @section Performing Dimensionality Analysis in GNAT
...@@ -23003,7 +22887,7 @@ passing (the dimension vector for the actual parameter must be equal to the ...@@ -23003,7 +22887,7 @@ passing (the dimension vector for the actual parameter must be equal to the
dimension vector for the formal parameter). dimension vector for the formal parameter).
@node Stack Related Facilities,Memory Management Issues,Performing Dimensionality Analysis in GNAT,GNAT and Program Execution @node Stack Related Facilities,Memory Management Issues,Performing Dimensionality Analysis in GNAT,GNAT and Program Execution
@anchor{gnat_ugn/gnat_and_program_execution stack-related-facilities}@anchor{29}@anchor{gnat_ugn/gnat_and_program_execution id60}@anchor{16c} @anchor{gnat_ugn/gnat_and_program_execution id57}@anchor{16b}@anchor{gnat_ugn/gnat_and_program_execution stack-related-facilities}@anchor{29}
@section Stack Related Facilities @section Stack Related Facilities
...@@ -23019,7 +22903,7 @@ particular, it deals with dynamic and static stack usage measurements. ...@@ -23019,7 +22903,7 @@ particular, it deals with dynamic and static stack usage measurements.
@end menu @end menu
@node Stack Overflow Checking,Static Stack Usage Analysis,,Stack Related Facilities @node Stack Overflow Checking,Static Stack Usage Analysis,,Stack Related Facilities
@anchor{gnat_ugn/gnat_and_program_execution id61}@anchor{1ca}@anchor{gnat_ugn/gnat_and_program_execution stack-overflow-checking}@anchor{f4} @anchor{gnat_ugn/gnat_and_program_execution id58}@anchor{1c4}@anchor{gnat_ugn/gnat_and_program_execution stack-overflow-checking}@anchor{f4}
@subsection Stack Overflow Checking @subsection Stack Overflow Checking
...@@ -23064,7 +22948,7 @@ Consequently, to modify the size of the environment task please refer to your ...@@ -23064,7 +22948,7 @@ Consequently, to modify the size of the environment task please refer to your
operating system documentation. operating system documentation.
@node Static Stack Usage Analysis,Dynamic Stack Usage Analysis,Stack Overflow Checking,Stack Related Facilities @node Static Stack Usage Analysis,Dynamic Stack Usage Analysis,Stack Overflow Checking,Stack Related Facilities
@anchor{gnat_ugn/gnat_and_program_execution static-stack-usage-analysis}@anchor{f5}@anchor{gnat_ugn/gnat_and_program_execution id62}@anchor{1cb} @anchor{gnat_ugn/gnat_and_program_execution static-stack-usage-analysis}@anchor{f5}@anchor{gnat_ugn/gnat_and_program_execution id59}@anchor{1c5}
@subsection Static Stack Usage Analysis @subsection Static Stack Usage Analysis
...@@ -23113,7 +22997,7 @@ subprogram whose stack usage might be larger than the specified amount of ...@@ -23113,7 +22997,7 @@ subprogram whose stack usage might be larger than the specified amount of
bytes. The wording is in keeping with the qualifier documented above. bytes. The wording is in keeping with the qualifier documented above.
@node Dynamic Stack Usage Analysis,,Static Stack Usage Analysis,Stack Related Facilities @node Dynamic Stack Usage Analysis,,Static Stack Usage Analysis,Stack Related Facilities
@anchor{gnat_ugn/gnat_and_program_execution dynamic-stack-usage-analysis}@anchor{121}@anchor{gnat_ugn/gnat_and_program_execution id63}@anchor{1cc} @anchor{gnat_ugn/gnat_and_program_execution dynamic-stack-usage-analysis}@anchor{121}@anchor{gnat_ugn/gnat_and_program_execution id60}@anchor{1c6}
@subsection Dynamic Stack Usage Analysis @subsection Dynamic Stack Usage Analysis
...@@ -23192,7 +23076,7 @@ The package @code{GNAT.Task_Stack_Usage} provides facilities to get ...@@ -23192,7 +23076,7 @@ The package @code{GNAT.Task_Stack_Usage} provides facilities to get
stack-usage reports at run time. See its body for the details. stack-usage reports at run time. See its body for the details.
@node Memory Management Issues,,Stack Related Facilities,GNAT and Program Execution @node Memory Management Issues,,Stack Related Facilities,GNAT and Program Execution
@anchor{gnat_ugn/gnat_and_program_execution id64}@anchor{16d}@anchor{gnat_ugn/gnat_and_program_execution memory-management-issues}@anchor{2a} @anchor{gnat_ugn/gnat_and_program_execution id61}@anchor{16c}@anchor{gnat_ugn/gnat_and_program_execution memory-management-issues}@anchor{2a}
@section Memory Management Issues @section Memory Management Issues
...@@ -23208,7 +23092,7 @@ incorrect uses of access values (including 'dangling references'). ...@@ -23208,7 +23092,7 @@ incorrect uses of access values (including 'dangling references').
@end menu @end menu
@node Some Useful Memory Pools,The GNAT Debug Pool Facility,,Memory Management Issues @node Some Useful Memory Pools,The GNAT Debug Pool Facility,,Memory Management Issues
@anchor{gnat_ugn/gnat_and_program_execution id65}@anchor{1cd}@anchor{gnat_ugn/gnat_and_program_execution some-useful-memory-pools}@anchor{1ce} @anchor{gnat_ugn/gnat_and_program_execution id62}@anchor{1c7}@anchor{gnat_ugn/gnat_and_program_execution some-useful-memory-pools}@anchor{1c8}
@subsection Some Useful Memory Pools @subsection Some Useful Memory Pools
...@@ -23289,7 +23173,7 @@ for T1'Storage_Size use 10_000; ...@@ -23289,7 +23173,7 @@ for T1'Storage_Size use 10_000;
@end quotation @end quotation
@node The GNAT Debug Pool Facility,,Some Useful Memory Pools,Memory Management Issues @node The GNAT Debug Pool Facility,,Some Useful Memory Pools,Memory Management Issues
@anchor{gnat_ugn/gnat_and_program_execution id66}@anchor{1cf}@anchor{gnat_ugn/gnat_and_program_execution the-gnat-debug-pool-facility}@anchor{1d0} @anchor{gnat_ugn/gnat_and_program_execution id63}@anchor{1c9}@anchor{gnat_ugn/gnat_and_program_execution the-gnat-debug-pool-facility}@anchor{1ca}
@subsection The GNAT Debug Pool Facility @subsection The GNAT Debug Pool Facility
...@@ -23452,7 +23336,7 @@ Debug Pool info: ...@@ -23452,7 +23336,7 @@ Debug Pool info:
@c -- E.g. Ada |nbsp| 95 @c -- E.g. Ada |nbsp| 95
@node Platform-Specific Information,Example of Binder Output File,GNAT and Program Execution,Top @node Platform-Specific Information,Example of Binder Output File,GNAT and Program Execution,Top
@anchor{gnat_ugn/platform_specific_information platform-specific-information}@anchor{d}@anchor{gnat_ugn/platform_specific_information doc}@anchor{1d1}@anchor{gnat_ugn/platform_specific_information id1}@anchor{1d2} @anchor{gnat_ugn/platform_specific_information platform-specific-information}@anchor{d}@anchor{gnat_ugn/platform_specific_information doc}@anchor{1cb}@anchor{gnat_ugn/platform_specific_information id1}@anchor{1cc}
@chapter Platform-Specific Information @chapter Platform-Specific Information
...@@ -23470,7 +23354,7 @@ topics related to the GNAT implementation on Windows and Mac OS. ...@@ -23470,7 +23354,7 @@ topics related to the GNAT implementation on Windows and Mac OS.
@end menu @end menu
@node Run-Time Libraries,Specifying a Run-Time Library,,Platform-Specific Information @node Run-Time Libraries,Specifying a Run-Time Library,,Platform-Specific Information
@anchor{gnat_ugn/platform_specific_information id2}@anchor{1d3}@anchor{gnat_ugn/platform_specific_information run-time-libraries}@anchor{2b} @anchor{gnat_ugn/platform_specific_information id2}@anchor{1cd}@anchor{gnat_ugn/platform_specific_information run-time-libraries}@anchor{2b}
@section Run-Time Libraries @section Run-Time Libraries
...@@ -23531,7 +23415,7 @@ information about several specific platforms. ...@@ -23531,7 +23415,7 @@ information about several specific platforms.
@end menu @end menu
@node Summary of Run-Time Configurations,,,Run-Time Libraries @node Summary of Run-Time Configurations,,,Run-Time Libraries
@anchor{gnat_ugn/platform_specific_information summary-of-run-time-configurations}@anchor{1d4}@anchor{gnat_ugn/platform_specific_information id3}@anchor{1d5} @anchor{gnat_ugn/platform_specific_information summary-of-run-time-configurations}@anchor{1ce}@anchor{gnat_ugn/platform_specific_information id3}@anchor{1cf}
@subsection Summary of Run-Time Configurations @subsection Summary of Run-Time Configurations
...@@ -23631,7 +23515,7 @@ ZCX ...@@ -23631,7 +23515,7 @@ ZCX
@node Specifying a Run-Time Library,GNU/Linux Topics,Run-Time Libraries,Platform-Specific Information @node Specifying a Run-Time Library,GNU/Linux Topics,Run-Time Libraries,Platform-Specific Information
@anchor{gnat_ugn/platform_specific_information specifying-a-run-time-library}@anchor{1d6}@anchor{gnat_ugn/platform_specific_information id4}@anchor{1d7} @anchor{gnat_ugn/platform_specific_information specifying-a-run-time-library}@anchor{1d0}@anchor{gnat_ugn/platform_specific_information id4}@anchor{1d1}
@section Specifying a Run-Time Library @section Specifying a Run-Time Library
...@@ -23718,7 +23602,7 @@ Alternatively, you can specify @code{rts-sjlj/adainclude} in the file ...@@ -23718,7 +23602,7 @@ Alternatively, you can specify @code{rts-sjlj/adainclude} in the file
Selecting another run-time library temporarily can be Selecting another run-time library temporarily can be
achieved by using the @code{--RTS} switch, e.g., @code{--RTS=sjlj} achieved by using the @code{--RTS} switch, e.g., @code{--RTS=sjlj}
@anchor{gnat_ugn/platform_specific_information choosing-the-scheduling-policy}@anchor{1d8} @anchor{gnat_ugn/platform_specific_information choosing-the-scheduling-policy}@anchor{1d2}
@geindex SCHED_FIFO scheduling policy @geindex SCHED_FIFO scheduling policy
@geindex SCHED_RR scheduling policy @geindex SCHED_RR scheduling policy
...@@ -23731,7 +23615,7 @@ achieved by using the @code{--RTS} switch, e.g., @code{--RTS=sjlj} ...@@ -23731,7 +23615,7 @@ achieved by using the @code{--RTS} switch, e.g., @code{--RTS=sjlj}
@end menu @end menu
@node Choosing the Scheduling Policy,,,Specifying a Run-Time Library @node Choosing the Scheduling Policy,,,Specifying a Run-Time Library
@anchor{gnat_ugn/platform_specific_information id5}@anchor{1d9} @anchor{gnat_ugn/platform_specific_information id5}@anchor{1d3}
@subsection Choosing the Scheduling Policy @subsection Choosing the Scheduling Policy
...@@ -23790,7 +23674,7 @@ Program_Error. ...@@ -23790,7 +23674,7 @@ Program_Error.
@geindex GNU/Linux @geindex GNU/Linux
@node GNU/Linux Topics,Microsoft Windows Topics,Specifying a Run-Time Library,Platform-Specific Information @node GNU/Linux Topics,Microsoft Windows Topics,Specifying a Run-Time Library,Platform-Specific Information
@anchor{gnat_ugn/platform_specific_information id6}@anchor{1da}@anchor{gnat_ugn/platform_specific_information gnu-linux-topics}@anchor{1db} @anchor{gnat_ugn/platform_specific_information id6}@anchor{1d4}@anchor{gnat_ugn/platform_specific_information gnu-linux-topics}@anchor{1d5}
@section GNU/Linux Topics @section GNU/Linux Topics
...@@ -23802,7 +23686,7 @@ This section describes topics that are specific to GNU/Linux platforms. ...@@ -23802,7 +23686,7 @@ This section describes topics that are specific to GNU/Linux platforms.
@end menu @end menu
@node Required Packages on GNU/Linux,,,GNU/Linux Topics @node Required Packages on GNU/Linux,,,GNU/Linux Topics
@anchor{gnat_ugn/platform_specific_information id7}@anchor{1dc}@anchor{gnat_ugn/platform_specific_information required-packages-on-gnu-linux}@anchor{1dd} @anchor{gnat_ugn/platform_specific_information id7}@anchor{1d6}@anchor{gnat_ugn/platform_specific_information required-packages-on-gnu-linux}@anchor{1d7}
@subsection Required Packages on GNU/Linux @subsection Required Packages on GNU/Linux
...@@ -23838,7 +23722,7 @@ for those packages. ...@@ -23838,7 +23722,7 @@ for those packages.
@geindex Windows @geindex Windows
@node Microsoft Windows Topics,Mac OS Topics,GNU/Linux Topics,Platform-Specific Information @node Microsoft Windows Topics,Mac OS Topics,GNU/Linux Topics,Platform-Specific Information
@anchor{gnat_ugn/platform_specific_information microsoft-windows-topics}@anchor{2c}@anchor{gnat_ugn/platform_specific_information id8}@anchor{1de} @anchor{gnat_ugn/platform_specific_information microsoft-windows-topics}@anchor{2c}@anchor{gnat_ugn/platform_specific_information id8}@anchor{1d8}
@section Microsoft Windows Topics @section Microsoft Windows Topics
...@@ -23861,7 +23745,7 @@ platforms. ...@@ -23861,7 +23745,7 @@ platforms.
@end menu @end menu
@node Using GNAT on Windows,Using a network installation of GNAT,,Microsoft Windows Topics @node Using GNAT on Windows,Using a network installation of GNAT,,Microsoft Windows Topics
@anchor{gnat_ugn/platform_specific_information using-gnat-on-windows}@anchor{1df}@anchor{gnat_ugn/platform_specific_information id9}@anchor{1e0} @anchor{gnat_ugn/platform_specific_information using-gnat-on-windows}@anchor{1d9}@anchor{gnat_ugn/platform_specific_information id9}@anchor{1da}
@subsection Using GNAT on Windows @subsection Using GNAT on Windows
...@@ -23938,7 +23822,7 @@ uninstall or integrate different GNAT products. ...@@ -23938,7 +23822,7 @@ uninstall or integrate different GNAT products.
@end itemize @end itemize
@node Using a network installation of GNAT,CONSOLE and WINDOWS subsystems,Using GNAT on Windows,Microsoft Windows Topics @node Using a network installation of GNAT,CONSOLE and WINDOWS subsystems,Using GNAT on Windows,Microsoft Windows Topics
@anchor{gnat_ugn/platform_specific_information id10}@anchor{1e1}@anchor{gnat_ugn/platform_specific_information using-a-network-installation-of-gnat}@anchor{1e2} @anchor{gnat_ugn/platform_specific_information id10}@anchor{1db}@anchor{gnat_ugn/platform_specific_information using-a-network-installation-of-gnat}@anchor{1dc}
@subsection Using a network installation of GNAT @subsection Using a network installation of GNAT
...@@ -23965,7 +23849,7 @@ transfer of large amounts of data across the network and will likely cause ...@@ -23965,7 +23849,7 @@ transfer of large amounts of data across the network and will likely cause
serious performance penalty. serious performance penalty.
@node CONSOLE and WINDOWS subsystems,Temporary Files,Using a network installation of GNAT,Microsoft Windows Topics @node CONSOLE and WINDOWS subsystems,Temporary Files,Using a network installation of GNAT,Microsoft Windows Topics
@anchor{gnat_ugn/platform_specific_information id11}@anchor{1e3}@anchor{gnat_ugn/platform_specific_information console-and-windows-subsystems}@anchor{1e4} @anchor{gnat_ugn/platform_specific_information id11}@anchor{1dd}@anchor{gnat_ugn/platform_specific_information console-and-windows-subsystems}@anchor{1de}
@subsection CONSOLE and WINDOWS subsystems @subsection CONSOLE and WINDOWS subsystems
...@@ -23990,7 +23874,7 @@ $ gnatmake winprog -largs -mwindows ...@@ -23990,7 +23874,7 @@ $ gnatmake winprog -largs -mwindows
@end quotation @end quotation
@node Temporary Files,Disabling Command Line Argument Expansion,CONSOLE and WINDOWS subsystems,Microsoft Windows Topics @node Temporary Files,Disabling Command Line Argument Expansion,CONSOLE and WINDOWS subsystems,Microsoft Windows Topics
@anchor{gnat_ugn/platform_specific_information id12}@anchor{1e5}@anchor{gnat_ugn/platform_specific_information temporary-files}@anchor{1e6} @anchor{gnat_ugn/platform_specific_information id12}@anchor{1df}@anchor{gnat_ugn/platform_specific_information temporary-files}@anchor{1e0}
@subsection Temporary Files @subsection Temporary Files
...@@ -24029,7 +23913,7 @@ environments where you may not have write access to some ...@@ -24029,7 +23913,7 @@ environments where you may not have write access to some
directories. directories.
@node Disabling Command Line Argument Expansion,Mixed-Language Programming on Windows,Temporary Files,Microsoft Windows Topics @node Disabling Command Line Argument Expansion,Mixed-Language Programming on Windows,Temporary Files,Microsoft Windows Topics
@anchor{gnat_ugn/platform_specific_information disabling-command-line-argument-expansion}@anchor{1e7} @anchor{gnat_ugn/platform_specific_information disabling-command-line-argument-expansion}@anchor{1e1}
@subsection Disabling Command Line Argument Expansion @subsection Disabling Command Line Argument Expansion
...@@ -24100,7 +23984,7 @@ Ada.Command_Line.Argument (1) -> "'*.txt'" ...@@ -24100,7 +23984,7 @@ Ada.Command_Line.Argument (1) -> "'*.txt'"
@end example @end example
@node Mixed-Language Programming on Windows,Windows Specific Add-Ons,Disabling Command Line Argument Expansion,Microsoft Windows Topics @node Mixed-Language Programming on Windows,Windows Specific Add-Ons,Disabling Command Line Argument Expansion,Microsoft Windows Topics
@anchor{gnat_ugn/platform_specific_information id13}@anchor{1e8}@anchor{gnat_ugn/platform_specific_information mixed-language-programming-on-windows}@anchor{1e9} @anchor{gnat_ugn/platform_specific_information id13}@anchor{1e2}@anchor{gnat_ugn/platform_specific_information mixed-language-programming-on-windows}@anchor{1e3}
@subsection Mixed-Language Programming on Windows @subsection Mixed-Language Programming on Windows
...@@ -24122,12 +24006,12 @@ to use the Microsoft tools for your C++ code, you have two choices: ...@@ -24122,12 +24006,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 Encapsulate your C++ code in a DLL to be linked with your Ada
application. In this case, use the Microsoft or whatever environment to application. In this case, use the Microsoft or whatever environment to
build the DLL and use GNAT to build your executable build the DLL and use GNAT to build your executable
(@ref{1ea,,Using DLLs with GNAT}). (@ref{1e4,,Using DLLs with GNAT}).
@item @item
Or you can encapsulate your Ada code in a DLL to be linked with the 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 other part of your application. In this case, use GNAT to build the DLL
(@ref{1eb,,Building DLLs with GNAT Project files}) and use the Microsoft (@ref{1e5,,Building DLLs with GNAT Project files}) and use the Microsoft
or whatever environment to build your executable. or whatever environment to build your executable.
@end itemize @end itemize
...@@ -24184,7 +24068,7 @@ native SEH support is used. ...@@ -24184,7 +24068,7 @@ native SEH support is used.
@end menu @end menu
@node Windows Calling Conventions,Introduction to Dynamic Link Libraries DLLs,,Mixed-Language Programming on Windows @node Windows Calling Conventions,Introduction to Dynamic Link Libraries DLLs,,Mixed-Language Programming on Windows
@anchor{gnat_ugn/platform_specific_information windows-calling-conventions}@anchor{1ec}@anchor{gnat_ugn/platform_specific_information id14}@anchor{1ed} @anchor{gnat_ugn/platform_specific_information windows-calling-conventions}@anchor{1e6}@anchor{gnat_ugn/platform_specific_information id14}@anchor{1e7}
@subsubsection Windows Calling Conventions @subsubsection Windows Calling Conventions
...@@ -24229,7 +24113,7 @@ are available for Windows: ...@@ -24229,7 +24113,7 @@ are available for Windows:
@end menu @end menu
@node C Calling Convention,Stdcall Calling Convention,,Windows Calling Conventions @node C Calling Convention,Stdcall Calling Convention,,Windows Calling Conventions
@anchor{gnat_ugn/platform_specific_information c-calling-convention}@anchor{1ee}@anchor{gnat_ugn/platform_specific_information id15}@anchor{1ef} @anchor{gnat_ugn/platform_specific_information c-calling-convention}@anchor{1e8}@anchor{gnat_ugn/platform_specific_information id15}@anchor{1e9}
@subsubsection @code{C} Calling Convention @subsubsection @code{C} Calling Convention
...@@ -24271,10 +24155,10 @@ is missing, as in the above example, this parameter is set to be the ...@@ -24271,10 +24155,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} 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 calling convention unless the object containing the variable is part of a
DLL (in which case you should use the @code{Stdcall} calling DLL (in which case you should use the @code{Stdcall} calling
convention, @ref{1f0,,Stdcall Calling Convention}). convention, @ref{1ea,,Stdcall Calling Convention}).
@node Stdcall Calling Convention,Win32 Calling Convention,C Calling Convention,Windows Calling Conventions @node Stdcall Calling Convention,Win32 Calling Convention,C Calling Convention,Windows Calling Conventions
@anchor{gnat_ugn/platform_specific_information stdcall-calling-convention}@anchor{1f0}@anchor{gnat_ugn/platform_specific_information id16}@anchor{1f1} @anchor{gnat_ugn/platform_specific_information stdcall-calling-convention}@anchor{1ea}@anchor{gnat_ugn/platform_specific_information id16}@anchor{1eb}
@subsubsection @code{Stdcall} Calling Convention @subsubsection @code{Stdcall} Calling Convention
...@@ -24371,7 +24255,7 @@ Note that to ease building cross-platform bindings this convention ...@@ -24371,7 +24255,7 @@ Note that to ease building cross-platform bindings this convention
will be handled as a @code{C} calling convention on non-Windows platforms. 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 @node Win32 Calling Convention,DLL Calling Convention,Stdcall Calling Convention,Windows Calling Conventions
@anchor{gnat_ugn/platform_specific_information win32-calling-convention}@anchor{1f2}@anchor{gnat_ugn/platform_specific_information id17}@anchor{1f3} @anchor{gnat_ugn/platform_specific_information win32-calling-convention}@anchor{1ec}@anchor{gnat_ugn/platform_specific_information id17}@anchor{1ed}
@subsubsection @code{Win32} Calling Convention @subsubsection @code{Win32} Calling Convention
...@@ -24379,7 +24263,7 @@ This convention, which is GNAT-specific is fully equivalent to the ...@@ -24379,7 +24263,7 @@ This convention, which is GNAT-specific is fully equivalent to the
@code{Stdcall} calling convention described above. @code{Stdcall} calling convention described above.
@node DLL Calling Convention,,Win32 Calling Convention,Windows Calling Conventions @node DLL Calling Convention,,Win32 Calling Convention,Windows Calling Conventions
@anchor{gnat_ugn/platform_specific_information id18}@anchor{1f4}@anchor{gnat_ugn/platform_specific_information dll-calling-convention}@anchor{1f5} @anchor{gnat_ugn/platform_specific_information id18}@anchor{1ee}@anchor{gnat_ugn/platform_specific_information dll-calling-convention}@anchor{1ef}
@subsubsection @code{DLL} Calling Convention @subsubsection @code{DLL} Calling Convention
...@@ -24387,7 +24271,7 @@ This convention, which is GNAT-specific is fully equivalent to the ...@@ -24387,7 +24271,7 @@ This convention, which is GNAT-specific is fully equivalent to the
@code{Stdcall} calling convention described above. @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 @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 id19}@anchor{1f6}@anchor{gnat_ugn/platform_specific_information introduction-to-dynamic-link-libraries-dlls}@anchor{1f7} @anchor{gnat_ugn/platform_specific_information id19}@anchor{1f0}@anchor{gnat_ugn/platform_specific_information introduction-to-dynamic-link-libraries-dlls}@anchor{1f1}
@subsubsection Introduction to Dynamic Link Libraries (DLLs) @subsubsection Introduction to Dynamic Link Libraries (DLLs)
...@@ -24471,10 +24355,10 @@ As a side note, an interesting difference between Microsoft DLLs and ...@@ -24471,10 +24355,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 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 routines are exported by default in a Unix shared library, while under
Windows it is possible (but not required) to list exported routines in Windows it is possible (but not required) to list exported routines in
a definition file (see @ref{1f8,,The Definition File}). a definition file (see @ref{1f2,,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 @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 id20}@anchor{1f9}@anchor{gnat_ugn/platform_specific_information using-dlls-with-gnat}@anchor{1ea} @anchor{gnat_ugn/platform_specific_information id20}@anchor{1f3}@anchor{gnat_ugn/platform_specific_information using-dlls-with-gnat}@anchor{1e4}
@subsubsection Using DLLs with GNAT @subsubsection Using DLLs with GNAT
...@@ -24565,7 +24449,7 @@ example a fictitious DLL called @code{API.dll}. ...@@ -24565,7 +24449,7 @@ example a fictitious DLL called @code{API.dll}.
@end menu @end menu
@node Creating an Ada Spec for the DLL Services,Creating an Import Library,,Using DLLs with GNAT @node Creating an Ada Spec for the DLL Services,Creating an Import Library,,Using DLLs with GNAT
@anchor{gnat_ugn/platform_specific_information id21}@anchor{1fa}@anchor{gnat_ugn/platform_specific_information creating-an-ada-spec-for-the-dll-services}@anchor{1fb} @anchor{gnat_ugn/platform_specific_information id21}@anchor{1f4}@anchor{gnat_ugn/platform_specific_information creating-an-ada-spec-for-the-dll-services}@anchor{1f5}
@subsubsection Creating an Ada Spec for the DLL Services @subsubsection Creating an Ada Spec for the DLL Services
...@@ -24605,7 +24489,7 @@ end API; ...@@ -24605,7 +24489,7 @@ end API;
@end quotation @end quotation
@node Creating an Import Library,,Creating an Ada Spec for the DLL Services,Using DLLs with GNAT @node Creating an Import Library,,Creating an Ada Spec for the DLL Services,Using DLLs with GNAT
@anchor{gnat_ugn/platform_specific_information id22}@anchor{1fc}@anchor{gnat_ugn/platform_specific_information creating-an-import-library}@anchor{1fd} @anchor{gnat_ugn/platform_specific_information id22}@anchor{1f6}@anchor{gnat_ugn/platform_specific_information creating-an-import-library}@anchor{1f7}
@subsubsection Creating an Import Library @subsubsection Creating an Import Library
...@@ -24619,7 +24503,7 @@ as in this case it is possible to link directly against the ...@@ -24619,7 +24503,7 @@ as in this case it is possible to link directly against the
DLL. Otherwise read on. DLL. Otherwise read on.
@geindex Definition file @geindex Definition file
@anchor{gnat_ugn/platform_specific_information the-definition-file}@anchor{1f8} @anchor{gnat_ugn/platform_specific_information the-definition-file}@anchor{1f2}
@subsubheading The Definition File @subsubheading The Definition File
...@@ -24667,17 +24551,17 @@ EXPORTS ...@@ -24667,17 +24551,17 @@ EXPORTS
@end table @end table
Note that you must specify the correct suffix (@code{@@@emph{nn}}) Note that you must specify the correct suffix (@code{@@@emph{nn}})
(see @ref{1ec,,Windows Calling Conventions}) for a Stdcall (see @ref{1e6,,Windows Calling Conventions}) for a Stdcall
calling convention function in the exported symbols list. calling convention function in the exported symbols list.
There can actually be other sections in a definition file, but these There can actually be other sections in a definition file, but these
sections are not relevant to the discussion at hand. sections are not relevant to the discussion at hand.
@anchor{gnat_ugn/platform_specific_information create-def-file-automatically}@anchor{1fe} @anchor{gnat_ugn/platform_specific_information create-def-file-automatically}@anchor{1f8}
@subsubheading Creating a Definition File Automatically @subsubheading Creating a Definition File Automatically
You can automatically create the definition file @code{API.def} You can automatically create the definition file @code{API.def}
(see @ref{1f8,,The Definition File}) from a DLL. (see @ref{1f2,,The Definition File}) from a DLL.
For that use the @code{dlltool} program as follows: For that use the @code{dlltool} program as follows:
@quotation @quotation
...@@ -24687,7 +24571,7 @@ $ dlltool API.dll -z API.def --export-all-symbols ...@@ -24687,7 +24571,7 @@ $ dlltool API.dll -z API.def --export-all-symbols
@end example @end example
Note that if some routines in the DLL have the @code{Stdcall} convention Note that if some routines in the DLL have the @code{Stdcall} convention
(@ref{1ec,,Windows Calling Conventions}) with stripped @code{@@@emph{nn}} (@ref{1e6,,Windows Calling Conventions}) with stripped @code{@@@emph{nn}}
suffix then you'll have to edit @code{api.def} to add it, and specify 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. @code{-k} to @code{gnatdll} when creating the import library.
...@@ -24711,13 +24595,13 @@ tells you what symbol is expected. You just have to go back to the ...@@ -24711,13 +24595,13 @@ tells you what symbol is expected. You just have to go back to the
definition file and add the right suffix. definition file and add the right suffix.
@end itemize @end itemize
@end quotation @end quotation
@anchor{gnat_ugn/platform_specific_information gnat-style-import-library}@anchor{1ff} @anchor{gnat_ugn/platform_specific_information gnat-style-import-library}@anchor{1f9}
@subsubheading GNAT-Style Import Library @subsubheading GNAT-Style Import Library
To create a static import library from @code{API.dll} with the GNAT tools 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 you should create the .def file, then use @code{gnatdll} tool
(see @ref{200,,Using gnatdll}) as follows: (see @ref{1fa,,Using gnatdll}) as follows:
@quotation @quotation
...@@ -24733,15 +24617,15 @@ definition file name is @code{xyz.def}, the import library name will ...@@ -24733,15 +24617,15 @@ definition file name is @code{xyz.def}, the import library name will
be @code{libxyz.a}. Note that in the previous example option be @code{libxyz.a}. Note that in the previous example option
@code{-e} could have been removed because the name of the definition @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 file (before the @code{.def} suffix) is the same as the name of the
DLL (@ref{200,,Using gnatdll} for more information about @code{gnatdll}). DLL (@ref{1fa,,Using gnatdll} for more information about @code{gnatdll}).
@end quotation @end quotation
@anchor{gnat_ugn/platform_specific_information msvs-style-import-library}@anchor{201} @anchor{gnat_ugn/platform_specific_information msvs-style-import-library}@anchor{1fb}
@subsubheading Microsoft-Style Import Library @subsubheading Microsoft-Style Import Library
A Microsoft import library is needed only if you plan to make an A Microsoft import library is needed only if you plan to make an
Ada DLL available to applications developed with Microsoft Ada DLL available to applications developed with Microsoft
tools (@ref{1e9,,Mixed-Language Programming on Windows}). tools (@ref{1e3,,Mixed-Language Programming on Windows}).
To create a Microsoft-style import library for @code{API.dll} you To create a Microsoft-style import library for @code{API.dll} you
should create the .def file, then build the actual import library using should create the .def file, then build the actual import library using
...@@ -24765,7 +24649,7 @@ See the Microsoft documentation for further details about the usage of ...@@ -24765,7 +24649,7 @@ See the Microsoft documentation for further details about the usage of
@end quotation @end quotation
@node Building DLLs with GNAT Project files,Building DLLs with GNAT,Using DLLs with GNAT,Mixed-Language Programming on Windows @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 id23}@anchor{202}@anchor{gnat_ugn/platform_specific_information building-dlls-with-gnat-project-files}@anchor{1eb} @anchor{gnat_ugn/platform_specific_information id23}@anchor{1fc}@anchor{gnat_ugn/platform_specific_information building-dlls-with-gnat-project-files}@anchor{1e5}
@subsubsection Building DLLs with GNAT Project files @subsubsection Building DLLs with GNAT Project files
...@@ -24781,7 +24665,7 @@ when inside the @code{DllMain} routine which is used for auto-initialization ...@@ -24781,7 +24665,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. 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 @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{203}@anchor{gnat_ugn/platform_specific_information id24}@anchor{204} @anchor{gnat_ugn/platform_specific_information building-dlls-with-gnat}@anchor{1fd}@anchor{gnat_ugn/platform_specific_information id24}@anchor{1fe}
@subsubsection Building DLLs with GNAT @subsubsection Building DLLs with GNAT
...@@ -24812,7 +24696,7 @@ $ gcc -shared -shared-libgcc -o api.dll obj1.o obj2.o ... ...@@ -24812,7 +24696,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 It is important to note that in this case all symbols found in the
object files are automatically exported. It is possible to restrict object files are automatically exported. It is possible to restrict
the set of symbols to export by passing to @code{gcc} a definition the set of symbols to export by passing to @code{gcc} a definition
file (see @ref{1f8,,The Definition File}). file (see @ref{1f2,,The Definition File}).
For example: For example:
@example @example
...@@ -24850,7 +24734,7 @@ $ gnatmake main -Iapilib -bargs -shared -largs -Lapilib -lAPI ...@@ -24850,7 +24734,7 @@ $ gnatmake main -Iapilib -bargs -shared -largs -Lapilib -lAPI
@end quotation @end quotation
@node Building DLLs with gnatdll,Ada DLLs and Finalization,Building DLLs with GNAT,Mixed-Language Programming on Windows @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{205}@anchor{gnat_ugn/platform_specific_information id25}@anchor{206} @anchor{gnat_ugn/platform_specific_information building-dlls-with-gnatdll}@anchor{1ff}@anchor{gnat_ugn/platform_specific_information id25}@anchor{200}
@subsubsection Building DLLs with gnatdll @subsubsection Building DLLs with gnatdll
...@@ -24858,8 +24742,8 @@ $ gnatmake main -Iapilib -bargs -shared -largs -Lapilib -lAPI ...@@ -24858,8 +24742,8 @@ $ gnatmake main -Iapilib -bargs -shared -largs -Lapilib -lAPI
@geindex building @geindex building
Note that it is preferred to use GNAT Project files Note that it is preferred to use GNAT Project files
(@ref{1eb,,Building DLLs with GNAT Project files}) or the built-in GNAT (@ref{1e5,,Building DLLs with GNAT Project files}) or the built-in GNAT
DLL support (@ref{203,,Building DLLs with GNAT}) or to build DLLs. DLL support (@ref{1fd,,Building DLLs with GNAT}) or to build DLLs.
This section explains how to build DLLs containing Ada code using This section explains how to build DLLs containing Ada code using
@code{gnatdll}. These DLLs will be referred to as Ada DLLs in the @code{gnatdll}. These DLLs will be referred to as Ada DLLs in the
...@@ -24875,20 +24759,20 @@ non-Ada applications are as follows: ...@@ -24875,20 +24759,20 @@ non-Ada applications are as follows:
You need to mark each Ada entity exported by the DLL with a @code{C} or 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 @code{Stdcall} calling convention to avoid any Ada name mangling for the
entities exported by the DLL entities exported by the DLL
(see @ref{207,,Exporting Ada Entities}). You can (see @ref{201,,Exporting Ada Entities}). You can
skip this step if you plan to use the Ada DLL only from Ada applications. skip this step if you plan to use the Ada DLL only from Ada applications.
@item @item
Your Ada code must export an initialization routine which calls the routine Your Ada code must export an initialization routine which calls the routine
@code{adainit} generated by @code{gnatbind} to perform the elaboration of @code{adainit} generated by @code{gnatbind} to perform the elaboration of
the Ada code in the DLL (@ref{208,,Ada DLLs and Elaboration}). The initialization the Ada code in the DLL (@ref{202,,Ada DLLs and Elaboration}). The initialization
routine exported by the Ada DLL must be invoked by the clients of the DLL routine exported by the Ada DLL must be invoked by the clients of the DLL
to initialize the DLL. to initialize the DLL.
@item @item
When useful, the DLL should also export a finalization routine which calls When useful, the DLL should also export a finalization routine which calls
routine @code{adafinal} generated by @code{gnatbind} to perform the routine @code{adafinal} generated by @code{gnatbind} to perform the
finalization of the Ada code in the DLL (@ref{209,,Ada DLLs and Finalization}). finalization of the Ada code in the DLL (@ref{203,,Ada DLLs and Finalization}).
The finalization routine exported by the Ada DLL must be invoked by the 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. clients of the DLL when the DLL services are no further needed.
...@@ -24898,11 +24782,11 @@ of the programming languages to which you plan to make the DLL available. ...@@ -24898,11 +24782,11 @@ of the programming languages to which you plan to make the DLL available.
@item @item
You must provide a definition file listing the exported entities You must provide a definition file listing the exported entities
(@ref{1f8,,The Definition File}). (@ref{1f2,,The Definition File}).
@item @item
Finally you must use @code{gnatdll} to produce the DLL and the import Finally you must use @code{gnatdll} to produce the DLL and the import
library (@ref{200,,Using gnatdll}). library (@ref{1fa,,Using gnatdll}).
@end itemize @end itemize
Note that a relocatable DLL stripped using the @code{strip} Note that a relocatable DLL stripped using the @code{strip}
...@@ -24922,7 +24806,7 @@ chapter of the @emph{GPRbuild User's Guide}. ...@@ -24922,7 +24806,7 @@ chapter of the @emph{GPRbuild User's Guide}.
@end menu @end menu
@node Limitations When Using Ada DLLs from Ada,Exporting Ada Entities,,Building DLLs with gnatdll @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{20a} @anchor{gnat_ugn/platform_specific_information limitations-when-using-ada-dlls-from-ada}@anchor{204}
@subsubsection Limitations When Using Ada DLLs from Ada @subsubsection Limitations When Using Ada DLLs from Ada
...@@ -24943,7 +24827,7 @@ It is completely safe to exchange plain elementary, array or record types, ...@@ -24943,7 +24827,7 @@ It is completely safe to exchange plain elementary, array or record types,
Windows object handles, etc. Windows object handles, etc.
@node Exporting Ada Entities,Ada DLLs and Elaboration,Limitations When Using Ada DLLs from Ada,Building DLLs with gnatdll @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{207}@anchor{gnat_ugn/platform_specific_information id26}@anchor{20b} @anchor{gnat_ugn/platform_specific_information exporting-ada-entities}@anchor{201}@anchor{gnat_ugn/platform_specific_information id26}@anchor{205}
@subsubsection Exporting Ada Entities @subsubsection Exporting Ada Entities
...@@ -25043,10 +24927,10 @@ end API; ...@@ -25043,10 +24927,10 @@ end API;
Note that if you do not export the Ada entities with a @code{C} or 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 @code{Stdcall} convention you will have to provide the mangled Ada names
in the definition file of the Ada DLL in the definition file of the Ada DLL
(@ref{20c,,Creating the Definition File}). (@ref{206,,Creating the Definition File}).
@node Ada DLLs and Elaboration,,Exporting Ada Entities,Building DLLs with gnatdll @node Ada DLLs and Elaboration,,Exporting Ada Entities,Building DLLs with gnatdll
@anchor{gnat_ugn/platform_specific_information ada-dlls-and-elaboration}@anchor{208}@anchor{gnat_ugn/platform_specific_information id27}@anchor{20d} @anchor{gnat_ugn/platform_specific_information ada-dlls-and-elaboration}@anchor{202}@anchor{gnat_ugn/platform_specific_information id27}@anchor{207}
@subsubsection Ada DLLs and Elaboration @subsubsection Ada DLLs and Elaboration
...@@ -25064,7 +24948,7 @@ the Ada elaboration routine @code{adainit} generated by the GNAT binder ...@@ -25064,7 +24948,7 @@ the Ada elaboration routine @code{adainit} generated by the GNAT binder
(@ref{b4,,Binding with Non-Ada Main Programs}). See the body of (@ref{b4,,Binding with Non-Ada Main Programs}). See the body of
@code{Initialize_Api} for an example. Note that the GNAT binder is @code{Initialize_Api} for an example. Note that the GNAT binder is
automatically invoked during the DLL build process by the @code{gnatdll} automatically invoked during the DLL build process by the @code{gnatdll}
tool (@ref{200,,Using gnatdll}). tool (@ref{1fa,,Using gnatdll}).
When a DLL is loaded, Windows systematically invokes a routine called When a DLL is loaded, Windows systematically invokes a routine called
@code{DllMain}. It would therefore be possible to call @code{adainit} @code{DllMain}. It would therefore be possible to call @code{adainit}
...@@ -25077,7 +24961,7 @@ time), which means that the GNAT run-time will deadlock waiting for the ...@@ -25077,7 +24961,7 @@ time), which means that the GNAT run-time will deadlock waiting for the
newly created task to complete its initialization. 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 @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 id28}@anchor{20e}@anchor{gnat_ugn/platform_specific_information ada-dlls-and-finalization}@anchor{209} @anchor{gnat_ugn/platform_specific_information id28}@anchor{208}@anchor{gnat_ugn/platform_specific_information ada-dlls-and-finalization}@anchor{203}
@subsubsection Ada DLLs and Finalization @subsubsection Ada DLLs and Finalization
...@@ -25092,10 +24976,10 @@ routine @code{adafinal} generated by the GNAT binder ...@@ -25092,10 +24976,10 @@ routine @code{adafinal} generated by the GNAT binder
See the body of @code{Finalize_Api} for an See the body of @code{Finalize_Api} for an
example. As already pointed out the GNAT binder is automatically invoked example. As already pointed out the GNAT binder is automatically invoked
during the DLL build process by the @code{gnatdll} tool during the DLL build process by the @code{gnatdll} tool
(@ref{200,,Using gnatdll}). (@ref{1fa,,Using gnatdll}).
@node Creating a Spec for Ada DLLs,GNAT and Windows Resources,Ada DLLs and Finalization,Mixed-Language Programming on Windows @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 id29}@anchor{20f}@anchor{gnat_ugn/platform_specific_information creating-a-spec-for-ada-dlls}@anchor{210} @anchor{gnat_ugn/platform_specific_information id29}@anchor{209}@anchor{gnat_ugn/platform_specific_information creating-a-spec-for-ada-dlls}@anchor{20a}
@subsubsection Creating a Spec for Ada DLLs @subsubsection Creating a Spec for Ada DLLs
...@@ -25153,7 +25037,7 @@ end API; ...@@ -25153,7 +25037,7 @@ end API;
@end menu @end menu
@node Creating the Definition File,Using gnatdll,,Creating a Spec for Ada DLLs @node Creating the Definition File,Using gnatdll,,Creating a Spec for Ada DLLs
@anchor{gnat_ugn/platform_specific_information creating-the-definition-file}@anchor{20c}@anchor{gnat_ugn/platform_specific_information id30}@anchor{211} @anchor{gnat_ugn/platform_specific_information creating-the-definition-file}@anchor{206}@anchor{gnat_ugn/platform_specific_information id30}@anchor{20b}
@subsubsection Creating the Definition File @subsubsection Creating the Definition File
...@@ -25189,7 +25073,7 @@ EXPORTS ...@@ -25189,7 +25073,7 @@ EXPORTS
@end quotation @end quotation
@node Using gnatdll,,Creating the Definition File,Creating a Spec for Ada DLLs @node Using gnatdll,,Creating the Definition File,Creating a Spec for Ada DLLs
@anchor{gnat_ugn/platform_specific_information using-gnatdll}@anchor{200}@anchor{gnat_ugn/platform_specific_information id31}@anchor{212} @anchor{gnat_ugn/platform_specific_information using-gnatdll}@anchor{1fa}@anchor{gnat_ugn/platform_specific_information id31}@anchor{20c}
@subsubsection Using @code{gnatdll} @subsubsection Using @code{gnatdll}
...@@ -25400,7 +25284,7 @@ asks @code{gnatlink} to generate the routines @code{DllMain} and ...@@ -25400,7 +25284,7 @@ asks @code{gnatlink} to generate the routines @code{DllMain} and
is loaded into memory. is loaded into memory.
@item @item
@code{gnatdll} uses @code{dlltool} (see @ref{213,,Using dlltool}) to build the @code{gnatdll} uses @code{dlltool} (see @ref{20d,,Using dlltool}) to build the
export table (@code{api.exp}). The export table contains the relocation 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 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. that the Windows loader is able to place the DLL anywhere in memory.
...@@ -25439,7 +25323,7 @@ $ gnatbind -n api ...@@ -25439,7 +25323,7 @@ $ gnatbind -n api
$ gnatlink api api.exp -o api.dll -mdll $ gnatlink api api.exp -o api.dll -mdll
@end example @end example
@end itemize @end itemize
@anchor{gnat_ugn/platform_specific_information using-dlltool}@anchor{213} @anchor{gnat_ugn/platform_specific_information using-dlltool}@anchor{20d}
@subsubheading Using @code{dlltool} @subsubheading Using @code{dlltool}
...@@ -25498,7 +25382,7 @@ DLL in the static import library generated by @code{dlltool} with switch ...@@ -25498,7 +25382,7 @@ DLL in the static import library generated by @code{dlltool} with switch
@item @code{-k} @item @code{-k}
Kill @code{@@@emph{nn}} from exported names Kill @code{@@@emph{nn}} from exported names
(@ref{1ec,,Windows Calling Conventions} (@ref{1e6,,Windows Calling Conventions}
for a discussion about @code{Stdcall}-style symbols. for a discussion about @code{Stdcall}-style symbols.
@end table @end table
...@@ -25554,7 +25438,7 @@ Use @code{assembler-name} as the assembler. The default is @code{as}. ...@@ -25554,7 +25438,7 @@ Use @code{assembler-name} as the assembler. The default is @code{as}.
@end table @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 @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{214}@anchor{gnat_ugn/platform_specific_information id32}@anchor{215} @anchor{gnat_ugn/platform_specific_information gnat-and-windows-resources}@anchor{20e}@anchor{gnat_ugn/platform_specific_information id32}@anchor{20f}
@subsubsection GNAT and Windows Resources @subsubsection GNAT and Windows Resources
...@@ -25649,7 +25533,7 @@ the corresponding Microsoft documentation. ...@@ -25649,7 +25533,7 @@ the corresponding Microsoft documentation.
@end menu @end menu
@node Building Resources,Compiling Resources,,GNAT and Windows Resources @node Building Resources,Compiling Resources,,GNAT and Windows Resources
@anchor{gnat_ugn/platform_specific_information building-resources}@anchor{216}@anchor{gnat_ugn/platform_specific_information id33}@anchor{217} @anchor{gnat_ugn/platform_specific_information building-resources}@anchor{210}@anchor{gnat_ugn/platform_specific_information id33}@anchor{211}
@subsubsection Building Resources @subsubsection Building Resources
...@@ -25669,7 +25553,7 @@ complete description of the resource script language can be found in the ...@@ -25669,7 +25553,7 @@ complete description of the resource script language can be found in the
Microsoft documentation. Microsoft documentation.
@node Compiling Resources,Using Resources,Building Resources,GNAT and Windows Resources @node Compiling Resources,Using Resources,Building Resources,GNAT and Windows Resources
@anchor{gnat_ugn/platform_specific_information compiling-resources}@anchor{218}@anchor{gnat_ugn/platform_specific_information id34}@anchor{219} @anchor{gnat_ugn/platform_specific_information compiling-resources}@anchor{212}@anchor{gnat_ugn/platform_specific_information id34}@anchor{213}
@subsubsection Compiling Resources @subsubsection Compiling Resources
...@@ -25711,7 +25595,7 @@ $ windres -i myres.res -o myres.o ...@@ -25711,7 +25595,7 @@ $ windres -i myres.res -o myres.o
@end quotation @end quotation
@node Using Resources,,Compiling Resources,GNAT and Windows Resources @node Using Resources,,Compiling Resources,GNAT and Windows Resources
@anchor{gnat_ugn/platform_specific_information using-resources}@anchor{21a}@anchor{gnat_ugn/platform_specific_information id35}@anchor{21b} @anchor{gnat_ugn/platform_specific_information using-resources}@anchor{214}@anchor{gnat_ugn/platform_specific_information id35}@anchor{215}
@subsubsection Using Resources @subsubsection Using Resources
...@@ -25731,7 +25615,7 @@ $ gnatmake myprog -largs myres.o ...@@ -25731,7 +25615,7 @@ $ gnatmake myprog -largs myres.o
@end quotation @end quotation
@node Using GNAT DLLs from Microsoft Visual Studio Applications,Debugging a DLL,GNAT and Windows Resources,Mixed-Language Programming on Windows @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{21c}@anchor{gnat_ugn/platform_specific_information using-gnat-dlls-from-microsoft-visual-studio-applications}@anchor{21d} @anchor{gnat_ugn/platform_specific_information using-gnat-dll-from-msvs}@anchor{216}@anchor{gnat_ugn/platform_specific_information using-gnat-dlls-from-microsoft-visual-studio-applications}@anchor{217}
@subsubsection Using GNAT DLLs from Microsoft Visual Studio Applications @subsubsection Using GNAT DLLs from Microsoft Visual Studio Applications
...@@ -25765,7 +25649,7 @@ $ gprbuild -p mylib.gpr ...@@ -25765,7 +25649,7 @@ $ gprbuild -p mylib.gpr
@item @item
Produce a .def file for the symbols you need to interface with, either by Produce a .def file for the symbols you need to interface with, either by
hand or automatically with possibly some manual adjustments hand or automatically with possibly some manual adjustments
(see @ref{1fe,,Creating Definition File Automatically}): (see @ref{1f8,,Creating Definition File Automatically}):
@end enumerate @end enumerate
@quotation @quotation
...@@ -25782,7 +25666,7 @@ $ dlltool libmylib.dll -z libmylib.def --export-all-symbols ...@@ -25782,7 +25666,7 @@ $ dlltool libmylib.dll -z libmylib.def --export-all-symbols
Make sure that MSVS command-line tools are accessible on the path. Make sure that MSVS command-line tools are accessible on the path.
@item @item
Create the Microsoft-style import library (see @ref{201,,MSVS-Style Import Library}): Create the Microsoft-style import library (see @ref{1fb,,MSVS-Style Import Library}):
@end enumerate @end enumerate
@quotation @quotation
...@@ -25824,7 +25708,7 @@ or copy the DLL into into the directory containing the .exe. ...@@ -25824,7 +25708,7 @@ or copy the DLL into into the directory containing the .exe.
@end enumerate @end enumerate
@node Debugging a DLL,Setting Stack Size from gnatlink,Using GNAT DLLs from Microsoft Visual Studio Applications,Mixed-Language Programming on Windows @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 id36}@anchor{21e}@anchor{gnat_ugn/platform_specific_information debugging-a-dll}@anchor{21f} @anchor{gnat_ugn/platform_specific_information id36}@anchor{218}@anchor{gnat_ugn/platform_specific_information debugging-a-dll}@anchor{219}
@subsubsection Debugging a DLL @subsubsection Debugging a DLL
...@@ -25862,7 +25746,7 @@ tools suite used to build the DLL. ...@@ -25862,7 +25746,7 @@ tools suite used to build the DLL.
@end menu @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 @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 id37}@anchor{220}@anchor{gnat_ugn/platform_specific_information program-and-dll-both-built-with-gcc-gnat}@anchor{221} @anchor{gnat_ugn/platform_specific_information id37}@anchor{21a}@anchor{gnat_ugn/platform_specific_information program-and-dll-both-built-with-gcc-gnat}@anchor{21b}
@subsubsection Program and DLL Both Built with GCC/GNAT @subsubsection Program and DLL Both Built with GCC/GNAT
...@@ -25872,7 +25756,7 @@ the process. Let's suppose here that the main procedure is named ...@@ -25872,7 +25756,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_main} and that in the DLL there is an entry point named
@code{ada_dll}. @code{ada_dll}.
The DLL (@ref{1f7,,Introduction to Dynamic Link Libraries (DLLs)}) and The DLL (@ref{1f1,,Introduction to Dynamic Link Libraries (DLLs)}) and
program must have been built with the debugging information (see GNAT -g program must have been built with the debugging information (see GNAT -g
switch). Here are the step-by-step instructions for debugging it: switch). Here are the step-by-step instructions for debugging it:
...@@ -25912,7 +25796,7 @@ you can use the standard approach to debug the whole program ...@@ -25912,7 +25796,7 @@ you can use the standard approach to debug the whole program
(@ref{24,,Running and Debugging Ada Programs}). (@ref{24,,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 @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 program-built-with-foreign-tools-and-dll-built-with-gcc-gnat}@anchor{222}@anchor{gnat_ugn/platform_specific_information id38}@anchor{223} @anchor{gnat_ugn/platform_specific_information program-built-with-foreign-tools-and-dll-built-with-gcc-gnat}@anchor{21c}@anchor{gnat_ugn/platform_specific_information id38}@anchor{21d}
@subsubsection Program Built with Foreign Tools and DLL Built with GCC/GNAT @subsubsection Program Built with Foreign Tools and DLL Built with GCC/GNAT
...@@ -25929,7 +25813,7 @@ example some C code built with Microsoft Visual C) and that there is a ...@@ -25929,7 +25813,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 DLL named @code{test.dll} containing an Ada entry point named
@code{ada_dll}. @code{ada_dll}.
The DLL (see @ref{1f7,,Introduction to Dynamic Link Libraries (DLLs)}) must have The DLL (see @ref{1f1,,Introduction to Dynamic Link Libraries (DLLs)}) must have
been built with debugging information (see the GNAT @code{-g} option). been built with debugging information (see the GNAT @code{-g} option).
@subsubheading Debugging the DLL Directly @subsubheading Debugging the DLL Directly
...@@ -26068,7 +25952,7 @@ approach to debug a program as described in ...@@ -26068,7 +25952,7 @@ approach to debug a program as described in
@ref{24,,Running and Debugging Ada Programs}. @ref{24,,Running and Debugging Ada Programs}.
@node Setting Stack Size from gnatlink,Setting Heap Size from gnatlink,Debugging a DLL,Mixed-Language Programming on Windows @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 setting-stack-size-from-gnatlink}@anchor{136}@anchor{gnat_ugn/platform_specific_information id39}@anchor{224} @anchor{gnat_ugn/platform_specific_information setting-stack-size-from-gnatlink}@anchor{136}@anchor{gnat_ugn/platform_specific_information id39}@anchor{21e}
@subsubsection Setting Stack Size from @code{gnatlink} @subsubsection Setting Stack Size from @code{gnatlink}
...@@ -26111,7 +25995,7 @@ because the comma is a separator for this option. ...@@ -26111,7 +25995,7 @@ because the comma is a separator for this option.
@end itemize @end itemize
@node Setting Heap Size from gnatlink,,Setting Stack Size from gnatlink,Mixed-Language Programming on Windows @node Setting Heap Size from gnatlink,,Setting Stack Size from gnatlink,Mixed-Language Programming on Windows
@anchor{gnat_ugn/platform_specific_information setting-heap-size-from-gnatlink}@anchor{137}@anchor{gnat_ugn/platform_specific_information id40}@anchor{225} @anchor{gnat_ugn/platform_specific_information setting-heap-size-from-gnatlink}@anchor{137}@anchor{gnat_ugn/platform_specific_information id40}@anchor{21f}
@subsubsection Setting Heap Size from @code{gnatlink} @subsubsection Setting Heap Size from @code{gnatlink}
...@@ -26144,7 +26028,7 @@ because the comma is a separator for this option. ...@@ -26144,7 +26028,7 @@ because the comma is a separator for this option.
@end itemize @end itemize
@node Windows Specific Add-Ons,,Mixed-Language Programming on Windows,Microsoft Windows Topics @node Windows Specific Add-Ons,,Mixed-Language Programming on Windows,Microsoft Windows Topics
@anchor{gnat_ugn/platform_specific_information windows-specific-add-ons}@anchor{226}@anchor{gnat_ugn/platform_specific_information win32-specific-addons}@anchor{227} @anchor{gnat_ugn/platform_specific_information windows-specific-add-ons}@anchor{220}@anchor{gnat_ugn/platform_specific_information win32-specific-addons}@anchor{221}
@subsection Windows Specific Add-Ons @subsection Windows Specific Add-Ons
...@@ -26157,7 +26041,7 @@ This section describes the Windows specific add-ons. ...@@ -26157,7 +26041,7 @@ This section describes the Windows specific add-ons.
@end menu @end menu
@node Win32Ada,wPOSIX,,Windows Specific Add-Ons @node Win32Ada,wPOSIX,,Windows Specific Add-Ons
@anchor{gnat_ugn/platform_specific_information win32ada}@anchor{228}@anchor{gnat_ugn/platform_specific_information id41}@anchor{229} @anchor{gnat_ugn/platform_specific_information win32ada}@anchor{222}@anchor{gnat_ugn/platform_specific_information id41}@anchor{223}
@subsubsection Win32Ada @subsubsection Win32Ada
...@@ -26188,7 +26072,7 @@ gprbuild p.gpr ...@@ -26188,7 +26072,7 @@ gprbuild p.gpr
@end quotation @end quotation
@node wPOSIX,,Win32Ada,Windows Specific Add-Ons @node wPOSIX,,Win32Ada,Windows Specific Add-Ons
@anchor{gnat_ugn/platform_specific_information id42}@anchor{22a}@anchor{gnat_ugn/platform_specific_information wposix}@anchor{22b} @anchor{gnat_ugn/platform_specific_information id42}@anchor{224}@anchor{gnat_ugn/platform_specific_information wposix}@anchor{225}
@subsubsection wPOSIX @subsubsection wPOSIX
...@@ -26221,7 +26105,7 @@ gprbuild p.gpr ...@@ -26221,7 +26105,7 @@ gprbuild p.gpr
@end quotation @end quotation
@node Mac OS Topics,,Microsoft Windows Topics,Platform-Specific Information @node Mac OS Topics,,Microsoft Windows Topics,Platform-Specific Information
@anchor{gnat_ugn/platform_specific_information mac-os-topics}@anchor{2d}@anchor{gnat_ugn/platform_specific_information id43}@anchor{22c} @anchor{gnat_ugn/platform_specific_information mac-os-topics}@anchor{2d}@anchor{gnat_ugn/platform_specific_information id43}@anchor{226}
@section Mac OS Topics @section Mac OS Topics
...@@ -26236,7 +26120,7 @@ platform. ...@@ -26236,7 +26120,7 @@ platform.
@end menu @end menu
@node Codesigning the Debugger,,,Mac OS Topics @node Codesigning the Debugger,,,Mac OS Topics
@anchor{gnat_ugn/platform_specific_information codesigning-the-debugger}@anchor{22d} @anchor{gnat_ugn/platform_specific_information codesigning-the-debugger}@anchor{227}
@subsection Codesigning the Debugger @subsection Codesigning the Debugger
...@@ -26317,7 +26201,7 @@ the location where you installed GNAT. Also, be sure that users are ...@@ -26317,7 +26201,7 @@ the location where you installed GNAT. Also, be sure that users are
in the Unix group @code{_developer}. in the Unix group @code{_developer}.
@node Example of Binder Output File,Elaboration Order Handling in GNAT,Platform-Specific Information,Top @node Example of Binder Output File,Elaboration Order Handling in GNAT,Platform-Specific Information,Top
@anchor{gnat_ugn/example_of_binder_output example-of-binder-output-file}@anchor{e}@anchor{gnat_ugn/example_of_binder_output doc}@anchor{22e}@anchor{gnat_ugn/example_of_binder_output id1}@anchor{22f} @anchor{gnat_ugn/example_of_binder_output example-of-binder-output-file}@anchor{e}@anchor{gnat_ugn/example_of_binder_output doc}@anchor{228}@anchor{gnat_ugn/example_of_binder_output id1}@anchor{229}
@chapter Example of Binder Output File @chapter Example of Binder Output File
...@@ -27069,7 +26953,7 @@ elaboration code in your own application). ...@@ -27069,7 +26953,7 @@ elaboration code in your own application).
@c -- Example: A |withing| unit has a |with| clause, it |withs| a |withed| unit @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 @node Elaboration Order Handling in GNAT,Inline Assembler,Example of Binder Output File,Top
@anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-order-handling-in-gnat}@anchor{f}@anchor{gnat_ugn/elaboration_order_handling_in_gnat doc}@anchor{230}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id1}@anchor{231} @anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-order-handling-in-gnat}@anchor{f}@anchor{gnat_ugn/elaboration_order_handling_in_gnat doc}@anchor{22a}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id1}@anchor{22b}
@chapter Elaboration Order Handling in GNAT @chapter Elaboration Order Handling in GNAT
...@@ -27103,7 +26987,7 @@ GNAT, either automatically or with explicit programming features. ...@@ -27103,7 +26987,7 @@ GNAT, either automatically or with explicit programming features.
@end menu @end menu
@node Elaboration Code,Elaboration Order,,Elaboration Order Handling in GNAT @node Elaboration Code,Elaboration Order,,Elaboration Order Handling in GNAT
@anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-code}@anchor{232}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id2}@anchor{233} @anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-code}@anchor{22c}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id2}@anchor{22d}
@section Elaboration Code @section Elaboration Code
...@@ -27245,7 +27129,7 @@ elaborated. ...@@ -27245,7 +27129,7 @@ elaborated.
@end itemize @end itemize
@node Elaboration Order,Checking the Elaboration Order,Elaboration Code,Elaboration Order Handling in GNAT @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{234}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id3}@anchor{235} @anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-order}@anchor{22e}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id3}@anchor{22f}
@section Elaboration Order @section Elaboration Order
...@@ -27395,7 +27279,7 @@ avoids ABE problems should be chosen, however a compiler may not always find ...@@ -27395,7 +27279,7 @@ avoids ABE problems should be chosen, however a compiler may not always find
such an order due to complications with respect to control and data flow. 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 @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 id4}@anchor{236}@anchor{gnat_ugn/elaboration_order_handling_in_gnat checking-the-elaboration-order}@anchor{237} @anchor{gnat_ugn/elaboration_order_handling_in_gnat id4}@anchor{230}@anchor{gnat_ugn/elaboration_order_handling_in_gnat checking-the-elaboration-order}@anchor{231}
@section Checking the Elaboration Order @section Checking the Elaboration Order
...@@ -27457,7 +27341,7 @@ order. ...@@ -27457,7 +27341,7 @@ order.
@end itemize @end itemize
@node Controlling the Elaboration Order in Ada,Controlling the Elaboration Order in GNAT,Checking the Elaboration Order,Elaboration Order Handling in GNAT @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{238}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id5}@anchor{239} @anchor{gnat_ugn/elaboration_order_handling_in_gnat controlling-the-elaboration-order-in-ada}@anchor{232}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id5}@anchor{233}
@section Controlling the Elaboration Order in Ada @section Controlling the Elaboration Order in Ada
...@@ -27785,7 +27669,7 @@ is that the program continues to stay in the last state (one or more correct ...@@ -27785,7 +27669,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. orders exist) even if maintenance changes the bodies of targets.
@node Controlling the Elaboration Order in GNAT,Common Elaboration-model Traits,Controlling the Elaboration Order in Ada,Elaboration Order Handling in GNAT @node Controlling the Elaboration Order in GNAT,Common Elaboration-model Traits,Controlling the Elaboration Order in Ada,Elaboration Order Handling in GNAT
@anchor{gnat_ugn/elaboration_order_handling_in_gnat id6}@anchor{23a}@anchor{gnat_ugn/elaboration_order_handling_in_gnat controlling-the-elaboration-order-in-gnat}@anchor{23b} @anchor{gnat_ugn/elaboration_order_handling_in_gnat id6}@anchor{234}@anchor{gnat_ugn/elaboration_order_handling_in_gnat controlling-the-elaboration-order-in-gnat}@anchor{235}
@section Controlling the Elaboration Order in GNAT @section Controlling the Elaboration Order in GNAT
...@@ -27861,7 +27745,7 @@ The dynamic, legacy, and static models can be relaxed using compiler switch ...@@ -27861,7 +27745,7 @@ The dynamic, legacy, and static models can be relaxed using compiler switch
may not diagnose certain elaboration issues or install run-time checks. may not diagnose certain elaboration issues or install run-time checks.
@node Common Elaboration-model Traits,Dynamic Elaboration Model in GNAT,Controlling the Elaboration Order in GNAT,Elaboration Order Handling in GNAT @node Common Elaboration-model Traits,Dynamic Elaboration Model in GNAT,Controlling the Elaboration Order in GNAT,Elaboration Order Handling in GNAT
@anchor{gnat_ugn/elaboration_order_handling_in_gnat common-elaboration-model-traits}@anchor{23c}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id7}@anchor{23d} @anchor{gnat_ugn/elaboration_order_handling_in_gnat common-elaboration-model-traits}@anchor{236}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id7}@anchor{237}
@section Common Elaboration-model Traits @section Common Elaboration-model Traits
...@@ -27930,7 +27814,7 @@ data and control flow. The warnings can be suppressed selectively with @code{pra ...@@ -27930,7 +27814,7 @@ data and control flow. The warnings can be suppressed selectively with @code{pra
Warnigns (Off)} or globally with compiler switch @code{-gnatwL}. Warnigns (Off)} or globally with compiler switch @code{-gnatwL}.
@node Dynamic Elaboration Model in GNAT,Static Elaboration Model in GNAT,Common Elaboration-model Traits,Elaboration Order Handling in GNAT @node Dynamic Elaboration Model in GNAT,Static Elaboration Model in GNAT,Common Elaboration-model Traits,Elaboration Order Handling in GNAT
@anchor{gnat_ugn/elaboration_order_handling_in_gnat dynamic-elaboration-model-in-gnat}@anchor{23e}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id8}@anchor{23f} @anchor{gnat_ugn/elaboration_order_handling_in_gnat dynamic-elaboration-model-in-gnat}@anchor{238}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id8}@anchor{239}
@section Dynamic Elaboration Model in GNAT @section Dynamic Elaboration Model in GNAT
...@@ -27987,7 +27871,7 @@ is in effect. ...@@ -27987,7 +27871,7 @@ is in effect.
@end example @end example
@node Static Elaboration Model in GNAT,SPARK Elaboration Model in GNAT,Dynamic Elaboration Model in GNAT,Elaboration Order Handling in GNAT @node Static Elaboration Model in GNAT,SPARK Elaboration Model in GNAT,Dynamic Elaboration Model in GNAT,Elaboration Order Handling in GNAT
@anchor{gnat_ugn/elaboration_order_handling_in_gnat static-elaboration-model-in-gnat}@anchor{240}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id9}@anchor{241} @anchor{gnat_ugn/elaboration_order_handling_in_gnat static-elaboration-model-in-gnat}@anchor{23a}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id9}@anchor{23b}
@section Static Elaboration Model in GNAT @section Static Elaboration Model in GNAT
...@@ -28130,7 +28014,7 @@ elaborated prior to the body of @code{Static_Model}. ...@@ -28130,7 +28014,7 @@ elaborated prior to the body of @code{Static_Model}.
@end itemize @end itemize
@node SPARK Elaboration Model in GNAT,Legacy Elaboration Model in GNAT,Static Elaboration Model in GNAT,Elaboration Order Handling in GNAT @node SPARK Elaboration Model in GNAT,Legacy Elaboration Model in GNAT,Static Elaboration Model in GNAT,Elaboration Order Handling in GNAT
@anchor{gnat_ugn/elaboration_order_handling_in_gnat id10}@anchor{242}@anchor{gnat_ugn/elaboration_order_handling_in_gnat spark-elaboration-model-in-gnat}@anchor{243} @anchor{gnat_ugn/elaboration_order_handling_in_gnat id10}@anchor{23c}@anchor{gnat_ugn/elaboration_order_handling_in_gnat spark-elaboration-model-in-gnat}@anchor{23d}
@section SPARK Elaboration Model in GNAT @section SPARK Elaboration Model in GNAT
...@@ -28153,7 +28037,7 @@ external, and compiler switch @code{-gnatd.v} is in effect. ...@@ -28153,7 +28037,7 @@ external, and compiler switch @code{-gnatd.v} is in effect.
@end example @end example
@node Legacy Elaboration Model in GNAT,Mixing Elaboration Models,SPARK Elaboration Model in GNAT,Elaboration Order Handling in GNAT @node Legacy Elaboration Model in GNAT,Mixing Elaboration Models,SPARK Elaboration Model in GNAT,Elaboration Order Handling in GNAT
@anchor{gnat_ugn/elaboration_order_handling_in_gnat legacy-elaboration-model-in-gnat}@anchor{244} @anchor{gnat_ugn/elaboration_order_handling_in_gnat legacy-elaboration-model-in-gnat}@anchor{23e}
@section Legacy Elaboration Model in GNAT @section Legacy Elaboration Model in GNAT
...@@ -28164,7 +28048,7 @@ in terms of diagnostics and run-time checks. The legacy elaboration model is ...@@ -28164,7 +28048,7 @@ in terms of diagnostics and run-time checks. The legacy elaboration model is
enabled with compiler switch @code{-gnatH}. enabled with compiler switch @code{-gnatH}.
@node Mixing Elaboration Models,Elaboration Circularities,Legacy Elaboration Model in GNAT,Elaboration Order Handling in GNAT @node Mixing Elaboration Models,Elaboration Circularities,Legacy Elaboration Model in GNAT,Elaboration Order Handling in GNAT
@anchor{gnat_ugn/elaboration_order_handling_in_gnat mixing-elaboration-models}@anchor{245}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id11}@anchor{246} @anchor{gnat_ugn/elaboration_order_handling_in_gnat mixing-elaboration-models}@anchor{23f}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id11}@anchor{240}
@section Mixing Elaboration Models @section Mixing Elaboration Models
...@@ -28208,7 +28092,7 @@ warning: "y.ads" which has static elaboration checks ...@@ -28208,7 +28092,7 @@ warning: "y.ads" which has static elaboration checks
The warnings can be suppressed by binder switch @code{-ws}. The warnings can be suppressed by binder switch @code{-ws}.
@node Elaboration Circularities,Resolving Elaboration Circularities,Mixing Elaboration Models,Elaboration Order Handling in GNAT @node Elaboration Circularities,Resolving Elaboration Circularities,Mixing Elaboration Models,Elaboration Order Handling in GNAT
@anchor{gnat_ugn/elaboration_order_handling_in_gnat id12}@anchor{247}@anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-circularities}@anchor{248} @anchor{gnat_ugn/elaboration_order_handling_in_gnat id12}@anchor{241}@anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-circularities}@anchor{242}
@section Elaboration Circularities @section Elaboration Circularities
...@@ -28267,7 +28151,7 @@ they @emph{with}, must be elaborated prior to @code{Client}. However, @code{Serv ...@@ -28267,7 +28151,7 @@ they @emph{with}, must be elaborated prior to @code{Client}. However, @code{Serv
@code{Client}, and this leads to a circularity. @code{Client}, and this leads to a circularity.
@node Resolving Elaboration Circularities,Resolving Task Issues,Elaboration Circularities,Elaboration Order Handling in GNAT @node Resolving Elaboration Circularities,Resolving Task Issues,Elaboration Circularities,Elaboration Order Handling in GNAT
@anchor{gnat_ugn/elaboration_order_handling_in_gnat id13}@anchor{249}@anchor{gnat_ugn/elaboration_order_handling_in_gnat resolving-elaboration-circularities}@anchor{24a} @anchor{gnat_ugn/elaboration_order_handling_in_gnat id13}@anchor{243}@anchor{gnat_ugn/elaboration_order_handling_in_gnat resolving-elaboration-circularities}@anchor{244}
@section Resolving Elaboration Circularities @section Resolving Elaboration Circularities
...@@ -28435,7 +28319,7 @@ run-time checks. ...@@ -28435,7 +28319,7 @@ run-time checks.
@end itemize @end itemize
@node Resolving Task Issues,Elaboration-related Compiler Switches,Resolving Elaboration Circularities,Elaboration Order Handling in GNAT @node Resolving Task Issues,Elaboration-related Compiler Switches,Resolving Elaboration Circularities,Elaboration Order Handling in GNAT
@anchor{gnat_ugn/elaboration_order_handling_in_gnat id14}@anchor{24b}@anchor{gnat_ugn/elaboration_order_handling_in_gnat resolving-task-issues}@anchor{24c} @anchor{gnat_ugn/elaboration_order_handling_in_gnat id14}@anchor{245}@anchor{gnat_ugn/elaboration_order_handling_in_gnat resolving-task-issues}@anchor{246}
@section Resolving Task Issues @section Resolving Task Issues
...@@ -28731,7 +28615,7 @@ static model will verify that no entry calls take place at elaboration time. ...@@ -28731,7 +28615,7 @@ static model will verify that no entry calls take place at elaboration time.
@end itemize @end itemize
@node Elaboration-related Compiler Switches,Summary of Procedures for Elaboration Control,Resolving Task Issues,Elaboration Order Handling in GNAT @node Elaboration-related Compiler Switches,Summary of Procedures for Elaboration Control,Resolving Task Issues,Elaboration Order Handling in GNAT
@anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-related-compiler-switches}@anchor{24d}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id15}@anchor{24e} @anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-related-compiler-switches}@anchor{247}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id15}@anchor{248}
@section Elaboration-related Compiler Switches @section Elaboration-related Compiler Switches
...@@ -28908,7 +28792,7 @@ checks. The example above will still fail at run time with an ABE. ...@@ -28908,7 +28792,7 @@ checks. The example above will still fail at run time with an ABE.
@end table @end table
@node Summary of Procedures for Elaboration Control,Inspecting the Chosen Elaboration Order,Elaboration-related Compiler Switches,Elaboration Order Handling in GNAT @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 summary-of-procedures-for-elaboration-control}@anchor{24f}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id16}@anchor{250} @anchor{gnat_ugn/elaboration_order_handling_in_gnat summary-of-procedures-for-elaboration-control}@anchor{249}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id16}@anchor{24a}
@section Summary of Procedures for Elaboration Control @section Summary of Procedures for Elaboration Control
...@@ -28942,7 +28826,7 @@ indicate why a server unit must be elaborated prior to a client unit. ...@@ -28942,7 +28826,7 @@ indicate why a server unit must be elaborated prior to a client unit.
@item @item
If the warnings produced by the static model indicate that a task is If the warnings produced by the static model indicate that a task is
involved, consider the options in section @ref{24b,,Resolving Task Issues}. involved, consider the options in section @ref{245,,Resolving Task Issues}.
@item @item
If none of the steps outlined above resolve the circularity, use a more If none of the steps outlined above resolve the circularity, use a more
...@@ -28973,7 +28857,7 @@ Use the relaxed legacy dynamic elaboration model, with compiler switches ...@@ -28973,7 +28857,7 @@ Use the relaxed legacy dynamic elaboration model, with compiler switches
@end itemize @end itemize
@node Inspecting the Chosen Elaboration Order,,Summary of Procedures for Elaboration Control,Elaboration Order Handling in GNAT @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 inspecting-the-chosen-elaboration-order}@anchor{251}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id17}@anchor{252} @anchor{gnat_ugn/elaboration_order_handling_in_gnat inspecting-the-chosen-elaboration-order}@anchor{24b}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id17}@anchor{24c}
@section Inspecting the Chosen Elaboration Order @section Inspecting the Chosen Elaboration Order
...@@ -29110,7 +28994,7 @@ gdbstr (body) ...@@ -29110,7 +28994,7 @@ gdbstr (body)
@end example @end example
@node Inline Assembler,GNU Free Documentation License,Elaboration Order Handling in GNAT,Top @node Inline Assembler,GNU Free Documentation License,Elaboration Order Handling in GNAT,Top
@anchor{gnat_ugn/inline_assembler inline-assembler}@anchor{10}@anchor{gnat_ugn/inline_assembler doc}@anchor{253}@anchor{gnat_ugn/inline_assembler id1}@anchor{254} @anchor{gnat_ugn/inline_assembler inline-assembler}@anchor{10}@anchor{gnat_ugn/inline_assembler doc}@anchor{24d}@anchor{gnat_ugn/inline_assembler id1}@anchor{24e}
@chapter Inline Assembler @chapter Inline Assembler
...@@ -29169,7 +29053,7 @@ and with assembly language programming. ...@@ -29169,7 +29053,7 @@ and with assembly language programming.
@end menu @end menu
@node Basic Assembler Syntax,A Simple Example of Inline Assembler,,Inline Assembler @node Basic Assembler Syntax,A Simple Example of Inline Assembler,,Inline Assembler
@anchor{gnat_ugn/inline_assembler id2}@anchor{255}@anchor{gnat_ugn/inline_assembler basic-assembler-syntax}@anchor{256} @anchor{gnat_ugn/inline_assembler id2}@anchor{24f}@anchor{gnat_ugn/inline_assembler basic-assembler-syntax}@anchor{250}
@section Basic Assembler Syntax @section Basic Assembler Syntax
...@@ -29285,7 +29169,7 @@ Intel: Destination first; for example @code{mov eax, 4}@w{ } ...@@ -29285,7 +29169,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 @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{257}@anchor{gnat_ugn/inline_assembler id3}@anchor{258} @anchor{gnat_ugn/inline_assembler a-simple-example-of-inline-assembler}@anchor{251}@anchor{gnat_ugn/inline_assembler id3}@anchor{252}
@section A Simple Example of Inline Assembler @section A Simple Example of Inline Assembler
...@@ -29434,7 +29318,7 @@ If there are no errors, @code{as} will generate an object file ...@@ -29434,7 +29318,7 @@ If there are no errors, @code{as} will generate an object file
@code{nothing.out}. @code{nothing.out}.
@node Output Variables in Inline Assembler,Input Variables in Inline Assembler,A Simple Example of Inline Assembler,Inline Assembler @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{259}@anchor{gnat_ugn/inline_assembler output-variables-in-inline-assembler}@anchor{25a} @anchor{gnat_ugn/inline_assembler id4}@anchor{253}@anchor{gnat_ugn/inline_assembler output-variables-in-inline-assembler}@anchor{254}
@section Output Variables in Inline Assembler @section Output Variables in Inline Assembler
...@@ -29801,7 +29685,7 @@ end Get_Flags_3; ...@@ -29801,7 +29685,7 @@ end Get_Flags_3;
@end quotation @end quotation
@node Input Variables in Inline Assembler,Inlining Inline Assembler Code,Output Variables in Inline Assembler,Inline Assembler @node Input Variables in Inline Assembler,Inlining Inline Assembler Code,Output Variables in Inline Assembler,Inline Assembler
@anchor{gnat_ugn/inline_assembler id5}@anchor{25b}@anchor{gnat_ugn/inline_assembler input-variables-in-inline-assembler}@anchor{25c} @anchor{gnat_ugn/inline_assembler id5}@anchor{255}@anchor{gnat_ugn/inline_assembler input-variables-in-inline-assembler}@anchor{256}
@section Input Variables in Inline Assembler @section Input Variables in Inline Assembler
...@@ -29890,7 +29774,7 @@ _increment__incr.1: ...@@ -29890,7 +29774,7 @@ _increment__incr.1:
@end quotation @end quotation
@node Inlining Inline Assembler Code,Other Asm Functionality,Input Variables in Inline Assembler,Inline Assembler @node Inlining Inline Assembler Code,Other Asm Functionality,Input Variables in Inline Assembler,Inline Assembler
@anchor{gnat_ugn/inline_assembler id6}@anchor{25d}@anchor{gnat_ugn/inline_assembler inlining-inline-assembler-code}@anchor{25e} @anchor{gnat_ugn/inline_assembler id6}@anchor{257}@anchor{gnat_ugn/inline_assembler inlining-inline-assembler-code}@anchor{258}
@section Inlining Inline Assembler Code @section Inlining Inline Assembler Code
...@@ -29961,7 +29845,7 @@ movl %esi,%eax ...@@ -29961,7 +29845,7 @@ movl %esi,%eax
thus saving the overhead of stack frame setup and an out-of-line call. thus saving the overhead of stack frame setup and an out-of-line call.
@node Other Asm Functionality,,Inlining Inline Assembler Code,Inline Assembler @node Other Asm Functionality,,Inlining Inline Assembler Code,Inline Assembler
@anchor{gnat_ugn/inline_assembler other-asm-functionality}@anchor{25f}@anchor{gnat_ugn/inline_assembler id7}@anchor{260} @anchor{gnat_ugn/inline_assembler other-asm-functionality}@anchor{259}@anchor{gnat_ugn/inline_assembler id7}@anchor{25a}
@section Other @code{Asm} Functionality @section Other @code{Asm} Functionality
...@@ -29976,7 +29860,7 @@ and @code{Volatile}, which inhibits unwanted optimizations. ...@@ -29976,7 +29860,7 @@ and @code{Volatile}, which inhibits unwanted optimizations.
@end menu @end menu
@node The Clobber Parameter,The Volatile Parameter,,Other Asm Functionality @node The Clobber Parameter,The Volatile Parameter,,Other Asm Functionality
@anchor{gnat_ugn/inline_assembler the-clobber-parameter}@anchor{261}@anchor{gnat_ugn/inline_assembler id8}@anchor{262} @anchor{gnat_ugn/inline_assembler the-clobber-parameter}@anchor{25b}@anchor{gnat_ugn/inline_assembler id8}@anchor{25c}
@subsection The @code{Clobber} Parameter @subsection The @code{Clobber} Parameter
...@@ -30040,7 +29924,7 @@ Use 'register' name @code{memory} if you changed a memory location ...@@ -30040,7 +29924,7 @@ Use 'register' name @code{memory} if you changed a memory location
@end itemize @end itemize
@node The Volatile Parameter,,The Clobber Parameter,Other Asm Functionality @node The Volatile Parameter,,The Clobber Parameter,Other Asm Functionality
@anchor{gnat_ugn/inline_assembler the-volatile-parameter}@anchor{263}@anchor{gnat_ugn/inline_assembler id9}@anchor{264} @anchor{gnat_ugn/inline_assembler the-volatile-parameter}@anchor{25d}@anchor{gnat_ugn/inline_assembler id9}@anchor{25e}
@subsection The @code{Volatile} Parameter @subsection The @code{Volatile} Parameter
...@@ -30076,7 +29960,7 @@ to @code{True} only if the compiler's optimizations have created ...@@ -30076,7 +29960,7 @@ to @code{True} only if the compiler's optimizations have created
problems. problems.
@node GNU Free Documentation License,Index,Inline Assembler,Top @node GNU Free Documentation License,Index,Inline Assembler,Top
@anchor{share/gnu_free_documentation_license gnu-fdl}@anchor{1}@anchor{share/gnu_free_documentation_license doc}@anchor{265}@anchor{share/gnu_free_documentation_license gnu-free-documentation-license}@anchor{266} @anchor{share/gnu_free_documentation_license gnu-fdl}@anchor{1}@anchor{share/gnu_free_documentation_license doc}@anchor{25f}@anchor{share/gnu_free_documentation_license gnu-free-documentation-license}@anchor{260}
@chapter GNU Free Documentation License @chapter GNU Free Documentation License
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment