From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-wm1-x32a.google.com (mail-wm1-x32a.google.com [IPv6:2a00:1450:4864:20::32a]) by sourceware.org (Postfix) with ESMTPS id 03EC8385694D for ; Mon, 26 Sep 2022 09:15:21 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 03EC8385694D Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=adacore.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=adacore.com Received: by mail-wm1-x32a.google.com with SMTP id r133-20020a1c448b000000b003b494ffc00bso7099653wma.0 for ; Mon, 26 Sep 2022 02:15:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=adacore.com; s=google; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date; bh=L6bGDwvNvhJu8KE2eUJNqEToiyMXRR/wAqMtmWsGD8s=; b=Ch/+ZczsEdUwmBhCKJx0FJnPEkSmHuHLyqhlypjovPn5dhIDDzE/5wjtlPuE4+eroP RrYGOh7C4HTsqAPDPBFqQrTa9F14MeFX7BtqwHCBaToWORLSAHmRlShOQkmqFXrIBUqd xo1/Y5jOcXvZjZdYjx6LpnDpFP+q0fRKSsnAsJwP4BjXJXFiUS6rhy+WB6OmLS3RahHA tXSxHESYGriXGhLbaJTcrAHIV9WA3AJSWSyT/0IgsIhI0NOX1AelMBqwx3VaCpEyPR20 AeLpHFek/ZKfHbFnfBIT2r1OIcFhQDLB2dkhrHJIXkT/6aW1M4/X3wS6FQnK4oEZSLI/ y28g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date; bh=L6bGDwvNvhJu8KE2eUJNqEToiyMXRR/wAqMtmWsGD8s=; b=YdE+14p1x9Zrv686d+S0yB82o94h5V9RPL4B04nXflnMzwteK5Sok2OvrF7Ec2ybst dHoPFKQPDz3HwyzTc/qfcO2nZmhf7Bz/0CaRO8fFjTsBuGSHYzY8eUJFQ6twUpnUa8bw KIRNT6GJGjg5kwmpGsYq84pMxbAKpJQBeYYYui/37ErRsk3TEJnlhVNDqklz2YFayqRZ 38bPDE5jjT6PvVxilUYCSlzt9XRTvZZFod/ecIn3sXaB5Vi+CUNTWYSTG+tzpyHDu7m7 TezzwMvGlmJaN9yYVsHuKC93zCHmNBrWDDWCWTPbU0zfUl1wNcrwEexQIhFYEmzV9v8o Bnkg== X-Gm-Message-State: ACrzQf0GLAgeVxnJn7xCwUwjPVTDtlTPFD/d1cMA1tGcLGZj9pARfjej R1D4I4AqB9P0URNi/ymv18r8jgQiOhkSDw== X-Google-Smtp-Source: AMsMyM7fqkNrbiofiPxhFAjJinl2XieoqrLGXgj4Kjlpgigf7lj5qUQJk+x6FXjKd9SL5gCz0438eQ== X-Received: by 2002:a05:600c:3844:b0:3b4:becc:e43 with SMTP id s4-20020a05600c384400b003b4becc0e43mr21322681wmr.33.1664183719723; Mon, 26 Sep 2022 02:15:19 -0700 (PDT) Received: from localhost.localdomain (static-176-191-105-132.ftth.abo.bbox.fr. [176.191.105.132]) by smtp.gmail.com with ESMTPSA id w9-20020a5d5449000000b0022ca921dc67sm1363056wrv.88.2022.09.26.02.15.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 26 Sep 2022 02:15:19 -0700 (PDT) From: =?UTF-8?q?Marc=20Poulhi=C3=A8s?= To: gcc-patches@gcc.gnu.org Cc: =?UTF-8?q?K=C3=A9vin=20Le=20Gouguec?= Subject: [COMMITED] ada: Document support for the mold linker Date: Mon, 26 Sep 2022 11:15:16 +0200 Message-Id: <20220926091516.273390-1-poulhies@adacore.com> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-13.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,GIT_PATCH_0,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: From: Kévin Le Gouguec 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. --- ...building_executable_programs_with_gnat.rst | 28 +++++++++++++++++-- gcc/ada/gnat_ugn.texi | 10 +++---- 2 files changed, 30 insertions(+), 8 deletions(-) diff --git a/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst b/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst index 6a478095cfc..f675732aae2 100644 --- a/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst +++ b/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst @@ -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`` diff --git a/gcc/ada/gnat_ugn.texi b/gcc/ada/gnat_ugn.texi index f2cb1ed638a..d7bcf74e278 100644 --- a/gcc/ada/gnat_ugn.texi +++ b/gcc/ada/gnat_ugn.texi @@ -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 -- 2.25.1