FreeChainXenon/gcc
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

ada: Document support for the mold linker

Browse source 
gcc/ada/

	* doc/gnat_ugn/building_executable_programs_with_gnat.rst
	(Linker Switches): Document support for mold along with gold; add some
	advice regarding OpenSSL in the Pro version.
	* gnat_ugn.texi: Regenerate.
This commit is contained in:
Kévin Le Gouguec 2022-07-04 11:12:47 +02:00 • committed by Marc Poulhiès
parent 91c706565f
commit 6b8e3ee10f
2 changed files with 30 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

28
gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst
View file

@ -6229,11 +6229,33 @@ Linker switches can be specified after :switch:`-largs` builder switch.
.. index:: -fuse-ld=name
:switch:`-fuse-ld={name}`
Linker to be used. The default is ``bfd`` for :file:`ld.bfd`,
the alternative being ``gold`` for :file:`ld.gold`. The later is
a more recent and faster linker, but only available on GNU/Linux
Linker to be used. The default is ``bfd`` for :file:`ld.bfd`; ``gold``
(for :file:`ld.gold`) and ``mold`` (for :file:`ld.mold`) are more
recent and faster alternatives, but only available on GNU/Linux
platforms.
.. only:: PRO
The GNAT distribution for native Linux platforms includes ``mold``,
compiled against OpenSSL version 1.1; however, the distribution does
not include OpenSSL. In order to use this linker, you may either:
* use your system's OpenSSL library, if the version matches: in this
situation, you need not do anything beside using the
:switch:`-fuse-ld=mold` switch,
* obtain a source distribution for OpenSSL 1.1, compile the
:file:`libcrypto.so` library and install it in the directory of
your choice, then include this directory in the
:envvar:`LD_LIBRARY_PATH` environment variable,
* install another copy of ``mold`` by other means in the directory
of your choice, and include this directory in the :envvar:`PATH`
environment variable; you may find this alternative preferable if
the copy of ``mold`` included in GNAT does not suit your needs
(e.g. being able to link against your system's OpenSSL, or using
another version of ``mold``).
.. _Binding_with_gnatbind:
Binding with ``gnatbind``

10
gcc/ada/gnat_ugn.texi
View file

@ -19,7 +19,7 @@
@copying
@quotation
GNAT User's Guide for Native Platforms , Sep 09, 2022
GNAT User's Guide for Native Platforms , Sep 26, 2022
AdaCore
@ -15317,10 +15317,11 @@ Linker switches can be specified after @code{-largs} builder switch.
@item @code{-fuse-ld=`name'}
Linker to be used. The default is @code{bfd} for @code{ld.bfd},
the alternative being @code{gold} for @code{ld.gold}. The later is
a more recent and faster linker, but only available on GNU/Linux
Linker to be used. The default is @code{bfd} for @code{ld.bfd}; @code{gold}
(for @code{ld.gold}) and @code{mold} (for @code{ld.mold}) are more
recent and faster alternatives, but only available on GNU/Linux
platforms.
@end table
@node Binding with gnatbind,Linking with gnatlink,Linker Switches,Building Executable Programs with GNAT
@ -17932,7 +17933,6 @@ instr.ads
@c -- Example: A |withing| unit has a |with| clause, it |withs| a |withed| unit
@node GNAT and Program Execution,Platform-Specific Information,GNAT Utility Programs,Top