From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 2140) id 80B4938582A3; Fri, 23 Jun 2023 20:12:36 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 80B4938582A3 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1687551156; bh=o+6YJD76Hq9z5cNmQ+LMAvsxqrl3WVtSI8ofHiJIg1o=; h=From:To:Subject:Date:From; b=Huk2TA20kuyCEet9wcTJvK/qMVwTsiiSENYSkxdU86kwTXrSpovd9cXV7WLkESeSJ 65plo+MeJgsmZW2LWFGamFswJYsPTZPB9ogDkLmOrqbYX8x9s5hcLWlgkK1u0gBAQx ChEJ4f7x/O+zGDluDO48EYujfwzo6OLVtHjjdkoM= Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: Alexandre Oliva To: gcc-cvs@gcc.gnu.org Subject: [gcc(refs/users/aoliva/heads/testme)] hardcfr: mark throw-expected functions [ada doc] X-Act-Checkin: gcc X-Git-Author: Alexandre Oliva X-Git-Refname: refs/users/aoliva/heads/testme X-Git-Oldrev: fff8098cb98d4496c16d25e56e22078df6a2f2ad X-Git-Newrev: 9f7f95e8139b13e71ddfd4f13f732c19dbd692c4 Message-Id: <20230623201236.80B4938582A3@sourceware.org> Date: Fri, 23 Jun 2023 20:12:36 +0000 (GMT) List-Id: https://gcc.gnu.org/g:9f7f95e8139b13e71ddfd4f13f732c19dbd692c4 commit 9f7f95e8139b13e71ddfd4f13f732c19dbd692c4 Author: Alexandre Oliva Date: Fri Jun 23 17:09:57 2023 -0300 hardcfr: mark throw-expected functions [ada doc] Adjust documentation to reflect the introduction of -fhardcfr-check-noreturn-calls=no-xthrow. [changelog] * doc/gnat_rm/security_hardening_features.rst (Control Flow Redundancy): Add -fhardcfr-check-noreturn-calls=no-xthrow. Diff: --- gcc/ada/doc/gnat_rm/security_hardening_features.rst | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/gcc/ada/doc/gnat_rm/security_hardening_features.rst b/gcc/ada/doc/gnat_rm/security_hardening_features.rst index ad165cd6849..2eddf206763 100644 --- a/gcc/ada/doc/gnat_rm/security_hardening_features.rst +++ b/gcc/ada/doc/gnat_rm/security_hardening_features.rst @@ -487,17 +487,18 @@ gets modified as follows: end; -Verification may also be performed before No_Return calls, whether -only nothrow ones, with -:switch:`-fhardcfr-check-noreturn-calls=nothrow`, or all of them, with -:switch:`-fhardcfr-check-noreturn-calls=always`. The default is -:switch:`-fhardcfr-check-noreturn-calls=never` for this feature, that -disables checking before No_Return calls. +Verification may also be performed before No_Return calls, whether all +of them, with :switch:`-fhardcfr-check-noreturn-calls=always`; all but +internal subprograms involved in exception-raising or -reraising, with +:switch:`-fhardcfr-check-noreturn-calls=no-xthrow` (default); only +nothrow ones, with :switch:`-fhardcfr-check-noreturn-calls=nothrow`; +or none, with :switch:`-fhardcfr-check-noreturn-calls=never`. When a No_Return call returns control to its caller through an exception, verification may have already been performed before the -call, if :switch:`-fhardcfr-check-noreturn-calls=always` is in effect. -The compiler arranges for already-checked No_Return calls without a +call, if :switch:`-fhardcfr-check-noreturn-calls=always` or +:switch:`-fhardcfr-check-noreturn-calls=no-xthrow` is in effect. The +compiler arranges for already-checked No_Return calls without a preexisting handler to bypass the implicitly-added cleanup handler and thus the redundant check, but a local exception or cleanup handler, if present, will modify the set of visited blocks, and checking will take